n8n-mcp/README_CLAUDE_SETUP.md

Claude Desktop Configuration for n8n-MCP

Setup Instructions

1. Build the project first:

   cd /Users/romualdczlonkowski/Pliki/n8n-mcp/n8n-mcp
   npm run build
   npm run rebuild
   

2. Locate your Claude Desktop config file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

3. Add the n8n-documentation server to your config:

   {
     "mcpServers": {
       "n8n-documentation": {
         "command": "node",
         "args": [
           "/Users/johndoe/projects/n8n-mcp/dist/mcp/index.js"
         ],
         "env": {
           "NODE_ENV": "production"
         }
       }
     }
   }
   

   Note: Update the path in args to match your actual installation directory.

4. Restart Claude Desktop to load the new configuration.

Available Tools

Once configured, you'll have access to these tools in Claude:

• list_nodes - List and filter n8n nodes

  list_nodes({ package: "n8n-nodes-base", limit: 10 })
  

• get_node_info - Get detailed information about a specific node

  get_node_info({ nodeType: "httpRequest" })
  

• search_nodes - Search across all node documentation

  search_nodes({ query: "webhook", limit: 20 })
  

• list_ai_tools - List nodes that can be used as AI Agent tools

  list_ai_tools({})
  

• get_node_documentation - Get full documentation for a node

  get_node_documentation({ nodeType: "slack" })
  

• get_database_statistics - Get statistics about the node database

  get_database_statistics({})
  

Troubleshooting

1. If the server doesn't appear in Claude:

   • Check that the path in args is absolute and correct
   • Ensure you've run npm run build and npm run rebuild
   • Check ~/.n8n-mcp/logs/ for error logs

2. If tools return errors:

   • Ensure the database exists: data/nodes.db
   • Run npm run validate to check the database
   • Rebuild if necessary: npm run rebuild

3. For development/testing: You can also run with more verbose logging:

   {
     "mcpServers": {
       "n8n-documentation": {
         "command": "node",
         "args": [
           "/path/to/your/n8n-mcp/dist/mcp/index.js"
         ],
         "env": {
           "NODE_ENV": "development",
           "LOG_LEVEL": "debug"
         }
       }
     }
   }