{"_id":"@ahmad.soliman/mcp-n8n-server","_rev":"3-7045e4d9c44e3ca8b98d303b26fdd0b6","name":"@ahmad.soliman/mcp-n8n-server","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.1":{"name":"@ahmad.soliman/mcp-n8n-server","version":"1.0.1","keywords":["mcp","n8n","api","automation","claude","llm","model-context-protocol"],"author":"","license":"MIT","_id":"@ahmad.soliman/mcp-n8n-server@1.0.1","maintainers":[{"name":"ahmadsoliman","email":"ahmadadel92@gmail.com"}],"homepage":"https://github.com/ahmadsoliman/mcp-n8n-server#readme","bugs":{"url":"https://github.com/ahmadsoliman/mcp-n8n-server/issues"},"bin":{"mcp-n8n-server":"build/index.js","mcp-n8n-verify":"build/verify-connection.js"},"dist":{"shasum":"47dbdca6e77bce5f0a210b180dd303fa523e5acf","tarball":"https://registry.npmjs.org/@ahmad.soliman/mcp-n8n-server/-/mcp-n8n-server-1.0.1.tgz","fileCount":5,"integrity":"sha512-sktlWOJkg21bUQixpd5dIu3a9PVhNneNWi9Js3c2FFZEWv9VTMTpuaSVr6KCYNfsjwPoSgaQR+oS6jwMiE0Ezw==","signatures":[{"sig":"MEYCIQCccVTFjBIiOcegybGQ00s0I83Q+VvdWdrd8bj2DlOO2wIhAIcWsmRWUXQFIofTyTbLqk2+olH/6+tQcNu7Ti3U70yM","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14956},"main":"build/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"97a30508454ac86553e8f13cbffa6e65ba08c6c1","scripts":{"dev":"tsc && node build/index.js","test":"npm run verify","build":"tsc && chmod 755 build/index.js build/verify-connection.js","start":"node build/index.js","verify":"node build/verify-connection.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"ahmadsoliman","email":"ahmadadel92@gmail.com"},"repository":{"url":"git+https://github.com/ahmadsoliman/mcp-n8n-server.git","type":"git"},"_npmVersion":"11.1.0","description":"MCP server for n8n API integration","directories":{},"_nodeVersion":"23.8.0","dependencies":{"zod":"^3.24.2","cors":"^2.8.5","axios":"^1.6.7","dotenv":"^16.4.5","express":"^4.18.2","@modelcontextprotocol/sdk":"^1.8.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"nodemon":"^3.0.3","typescript":"^5.8.2","@types/node":"^22.13.14"},"_npmOperationalInternal":{"tmp":"tmp/mcp-n8n-server_1.0.1_1743354306888_0.4028511575333231","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@ahmad.soliman/mcp-n8n-server","version":"1.0.2","keywords":["mcp","n8n","api","automation","claude","llm","model-context-protocol"],"author":"","license":"MIT","_id":"@ahmad.soliman/mcp-n8n-server@1.0.2","maintainers":[{"name":"ahmadsoliman","email":"ahmadadel92@gmail.com"}],"homepage":"https://github.com/ahmadsoliman/mcp-n8n-server#readme","bugs":{"url":"https://github.com/ahmadsoliman/mcp-n8n-server/issues"},"bin":{"mcp-n8n-server":"build/index.js","mcp-n8n-verify":"build/verify-connection.js"},"dist":{"shasum":"db12aac47dc1298a074981a91c5e48029512da91","tarball":"https://registry.npmjs.org/@ahmad.soliman/mcp-n8n-server/-/mcp-n8n-server-1.0.2.tgz","fileCount":5,"integrity":"sha512-FmDIDK8QNudSe3jr1cePGAqer8AJUysq08BrI9oHFS71POD4QZOCCeUz9miHKQbIwXZMuH2deop63K3L6moFRQ==","signatures":[{"sig":"MEQCIERe7YWGyeeUwZsNr1OLt0RSInqA+cTQiEoyRD0Io8CFAiAKdPIzUhgkh2lm1kvLS/bXiMU6IH5763wQUlFhl1G0UQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14597},"main":"build/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"1c2938247f12c902ad396a5cbdd71a75c0fc7156","scripts":{"dev":"tsc && node build/index.js","test":"npm run verify","build":"tsc && chmod 755 build/index.js build/verify-connection.js","start":"node build/index.js","verify":"node build/verify-connection.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"ahmadsoliman","email":"ahmadadel92@gmail.com"},"repository":{"url":"git+https://github.com/ahmadsoliman/mcp-n8n-server.git","type":"git"},"_npmVersion":"11.1.0","description":"MCP server for n8n API integration","directories":{},"_nodeVersion":"23.8.0","dependencies":{"zod":"^3.24.2","cors":"^2.8.5","axios":"^1.6.7","dotenv":"^16.4.5","express":"^4.18.2","@modelcontextprotocol/sdk":"^1.8.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"nodemon":"^3.0.3","typescript":"^5.8.2","@types/node":"^22.13.14"},"_npmOperationalInternal":{"tmp":"tmp/mcp-n8n-server_1.0.2_1743355346726_0.9184766953825285","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@ahmad.soliman/mcp-n8n-server","version":"1.0.3","description":"MCP server for n8n API integration","main":"build/index.js","type":"module","bin":{"mcp-n8n-server":"build/index.js","mcp-n8n-verify":"build/verify-connection.js"},"scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","dev":"tsc && node build/index.js","verify":"node build/verify-connection.js","test":"npm run verify","prepublishOnly":"npm run build"},"keywords":["mcp","n8n","api","automation","claude","llm","model-context-protocol"],"author":"","license":"MIT","publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/ahmadsoliman/mcp-n8n-server.git"},"engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.8.0","axios":"^1.6.7","cors":"^2.8.5","dotenv":"^16.4.5","express":"^4.18.2","zod":"^3.24.2"},"devDependencies":{"@types/node":"^22.13.14","nodemon":"^3.0.3","typescript":"^5.8.2"},"_id":"@ahmad.soliman/mcp-n8n-server@1.0.3","gitHead":"e72feceeb772a4a451ddcb4c39215c59ac1ffe07","bugs":{"url":"https://github.com/ahmadsoliman/mcp-n8n-server/issues"},"homepage":"https://github.com/ahmadsoliman/mcp-n8n-server#readme","_nodeVersion":"23.8.0","_npmVersion":"11.1.0","dist":{"integrity":"sha512-oo+G7JjqJXZ1YOg90uKPZmso60D85zI18aqb+/27OgIBCmf0emw0Mb43sjOGQYRPagyMHhJ5JXzmBKrAAcz6RQ==","shasum":"f4c6f04c1fa6edf985d242a3f8187f8599b50a79","tarball":"https://registry.npmjs.org/@ahmad.soliman/mcp-n8n-server/-/mcp-n8n-server-1.0.3.tgz","fileCount":5,"unpackedSize":14725,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDWXnQxFjgft8py/p0fD9IypGuPwEPF1494OgMH37IFXQIhAKxecZbgLGPPhlsGDBUkmo0lafLqXCGUEj94RifxluU+"}]},"_npmUser":{"name":"ahmadsoliman","email":"ahmadadel92@gmail.com"},"directories":{},"maintainers":[{"name":"ahmadsoliman","email":"ahmadadel92@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-n8n-server_1.0.3_1743373763346_0.34896102722548816"},"_hasShrinkwrap":false}},"time":{"created":"2025-03-30T17:05:06.816Z","modified":"2025-03-30T22:29:23.735Z","1.0.1":"2025-03-30T17:05:07.073Z","1.0.2":"2025-03-30T17:22:26.912Z","1.0.3":"2025-03-30T22:29:23.529Z"},"bugs":{"url":"https://github.com/ahmadsoliman/mcp-n8n-server/issues"},"license":"MIT","homepage":"https://github.com/ahmadsoliman/mcp-n8n-server#readme","keywords":["mcp","n8n","api","automation","claude","llm","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/ahmadsoliman/mcp-n8n-server.git"},"description":"MCP server for n8n API integration","maintainers":[{"name":"ahmadsoliman","email":"ahmadadel92@gmail.com"}],"readme":"# MCP n8n API Server\n\nAn mcp server that provides an interface to interact with n8n workflows through the Model Context Protocol (MCP).\n\n## Features\n\n- List all n8n workflows\n- Trigger specific workflows with custom data\n- Integration with Claude Desktop and other MCP clients\n\n## Installation\n\n### Global Installation (Recommended for Remote Usage)\n\n```bash\nnpm install -g @ahmad.soliman/mcp-n8n-server\n```\n\nThen configure your n8n connection:\n\n1. Create a `.env` file in your working directory\n2. Add your n8n API information (see Configuration section below)\n\n### Using with npx (No Installation Required)\n\nYou can run the server directly with npx:\n\n```bash\nnpx -y @ahmad.soliman/mcp-n8n-server\n```\n\n### Local Installation\n\n```bash\ngit clone https://github.com/ahmadsoliman/mcp-n8n-server.git\ncd mcp-n8n-server\nnpm install\n```\n\n## Configuration\n\nCreate a `.env` file with the following variables:\n\n```\n# n8n Host URL (required)\nN8N_HOST_URL=https://your-n8n-instance.com\n\n# n8n Project ID (optional - only needed for cloud instances)\nPROJECT_ID=your_project_id_here\n\n# n8n API Key (required)\nN8N_API_KEY=your_api_key_here\n```\n\n## Usage\n\n### As a Remote MCP Server\n\nAfter installing globally, you can use it as a remote MCP server with Claude AI:\n\n1. Configure Claude AI to use this as a remote MCP server using the following JSON configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"n8n\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ahmad.soliman/mcp-n8n-server\"],\n      \"env\": {\n        \"N8N_HOST_URL\": \"\",\n        \"PROJECT_ID\": \"\",\n        \"N8N_API_KEY\": \"\"\n      }\n    }\n  }\n}\n```\n\n2. Add the following to your prompt or instructions to Claude:\n\n```\nYou have access to a remote MCP server for n8n integration. Use it to:\n- List all n8n workflows\n- Trigger webhooks and workflows\n- Get information about available webhooks\n```\n\n### As a Local MCP Server\n\nYou can run the server locally and connect to it from Claude Desktop:\n\n```bash\n# Start the server\nnpm start\n```\n\nThen configure Claude Desktop to use this MCP server:\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"n8n\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ahmad.soliman/mcp-n8n-server\"],\n      \"env\": {\n        \"N8N_HOST_URL\": \"\",\n        \"PROJECT_ID\": \"\",\n        \"N8N_API_KEY\": \"\"\n      }\n    }\n  }\n}\n```\n\nAlternatively, if you've cloned the repository locally:\n\n```json\n{\n  \"mcpServers\": {\n    \"n8n-server\": {\n      \"command\": \"node\",\n      \"args\": [\"/ABSOLUTE/PATH/TO/server-n8n/build/index.js\"]\n    }\n  }\n}\n```\n\n## Setup\n\n1. Install dependencies:\n\n```bash\nnpm install\n```\n\n2. Configure environment variables:\n\n- Copy `.env.example` to `.env` (if not already done)\n- Update the following variables in `.env`:\n  - `N8N_API_URL`: Your n8n instance URL (default: http://localhost:5678)\n  - `N8N_API_KEY`: Your n8n API key\n\n3. Start the server:\n\n```bash\n# Start the MCP server (for integration with Claude Desktop and other MCP clients)\nnpm run mcp\n```\n\nFor development with auto-reload:\n\n```bash\nnpm run dev\n```\n\n## MCP Tools (for LLM Integration)\n\nThe MCP server exposes the following tools for use with Claude Desktop or other MCP clients:\n\n### List Workflows\n\nThe `list-workflows` tool returns a list of all available n8n workflows.\n\n### List Workflow Webhooks\n\nThe `list-workflow-webhooks` tool returns all webhooks from a specific workflow.\n\nParameters:\n\n- `id`: The ID of the workflow to get webhooks from\n\n### Call Webhook (GET)\n\nThe `call-webhook-get` tool allows calling a webhook with a GET request.\n\nParameters:\n\n- `url`: The webhook URL to call\n\n### Call Webhook (POST)\n\nThe `call-webhook-post` tool allows calling a webhook with a POST request.\n\nParameters:\n\n- `url`: The webhook URL to call\n- `data`: Data to send in the POST request body\n","readmeFilename":"README.md"}