{"_id":"@bossforce.ai/mcp-n8n","name":"@bossforce.ai/mcp-n8n","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@bossforce.ai/mcp-n8n","version":"0.1.0","type":"module","repository":{"type":"git","url":"git+https://github.com/bossforce-ai/bossforce-tools.git","directory":"mcps/automation/n8n"},"publishConfig":{"access":"public"},"bin":{"bossforce-mcp-n8n":"dist/bin.js"},"dependencies":{"zod":"^4.4.3","@bossforce.ai/mcp-core":"0.3.0"},"devDependencies":{"@bossforce.ai/mcp-testkit":"0.0.0"},"scripts":{"build":"tsc -p tsconfig.json","test":"node --test \"dist/*.test.js\""},"_id":"@bossforce.ai/mcp-n8n@0.1.0","description":"MCP server for the [n8n](https://n8n.io/) **public REST API**, using API key authentication. A good fit for monitoring and controlling automations — listing and inspecting workflows and executions, and activating or deactivating workflows — from an agent.","bugs":{"url":"https://github.com/bossforce-ai/bossforce-tools/issues"},"homepage":"https://github.com/bossforce-ai/bossforce-tools#readme","_integrity":"sha512-SnIS4bdOR2MQPyrk1kgxMKPlIW7rMxSFKtSTz28Kfm07VKUy0JP5LPeaiIm/e0gUh1J+u5+bMAHg0XlSPBO1+w==","_resolved":"C:\\Users\\user\\AppData\\Local\\Temp\\b29f3fe24982ce39c2e76de4cf185a55\\bossforce.ai-mcp-n8n-0.1.0.tgz","_from":"file:bossforce.ai-mcp-n8n-0.1.0.tgz","_nodeVersion":"22.18.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-SnIS4bdOR2MQPyrk1kgxMKPlIW7rMxSFKtSTz28Kfm07VKUy0JP5LPeaiIm/e0gUh1J+u5+bMAHg0XlSPBO1+w==","shasum":"af504811c98e447be7fcdd475520c1692368ae29","tarball":"https://registry.npmjs.org/@bossforce.ai/mcp-n8n/-/mcp-n8n-0.1.0.tgz","fileCount":26,"unpackedSize":27622,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDqRzZC0cxIrJPT75b8oxKxiQPq/PoXXW5obaAgatZVAgIhAM/XDcWWvtFziAG1sw8wYkZ9KHYSeAIOaeNOnJq14MS+"}]},"_npmUser":{"name":"bossforce.ai","email":"bossforce.ai@gmail.com"},"directories":{},"maintainers":[{"name":"bossforce.ai","email":"bossforce.ai@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-n8n_0.1.0_1781069226554_0.8749944579248115"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-10T05:27:06.442Z","0.1.0":"2026-06-10T05:27:06.694Z","modified":"2026-06-10T05:27:06.884Z"},"maintainers":[{"name":"bossforce.ai","email":"bossforce.ai@gmail.com"}],"description":"MCP server for the [n8n](https://n8n.io/) **public REST API**, using API key authentication. A good fit for monitoring and controlling automations — listing and inspecting workflows and executions, and activating or deactivating workflows — from an agent.","homepage":"https://github.com/bossforce-ai/bossforce-tools#readme","repository":{"type":"git","url":"git+https://github.com/bossforce-ai/bossforce-tools.git","directory":"mcps/automation/n8n"},"bugs":{"url":"https://github.com/bossforce-ai/bossforce-tools/issues"},"readme":"# @bossforce.ai/mcp-n8n\n\nMCP server for the [n8n](https://n8n.io/) **public REST API**, using API key\nauthentication. A good fit for monitoring and controlling automations — listing\nand inspecting workflows and executions, and activating or deactivating\nworkflows — from an agent.\n\n## Credentials\n\n| Env            | Secret | How to obtain                                                                                     |\n| -------------- | ------ | ------------------------------------------------------------------------------------------------- |\n| `N8N_BASE_URL` | no     | Base URL of your instance, e.g. `https://your-n8n.example.com` or `https://<name>.app.n8n.cloud`. |\n| `N8N_API_KEY`  | yes    | In n8n, open Settings > [n8n API](https://docs.n8n.io/api/authentication/) and create an API key. |\n\nCredentials are read lazily, so the server boots and answers `tools/list`\nwithout them; calls fail with an `auth` error until they are set. The public API\nmust be enabled on the instance — it is available on self-hosted n8n and on n8n\nCloud paid plans.\n\nAuthentication sends the API key in the `X-N8N-API-KEY` header. The API base URL\nis built from the instance URL (`https://{host}/api/v1`).\n\n## Tools\n\n| Tool                  | Arguments                                                                               | Returns                     |\n| --------------------- | --------------------------------------------------------------------------------------- | --------------------------- |\n| `list_workflows`      | `active?`, `tags?`, `name?`, `project_id?`, `exclude_pinned_data?`, `limit?`, `cursor?` | `{ data, nextCursor }`      |\n| `get_workflow`        | `workflow_id`, `exclude_pinned_data?`                                                   | the workflow object         |\n| `activate_workflow`   | `workflow_id`                                                                           | the updated workflow object |\n| `deactivate_workflow` | `workflow_id`                                                                           | the updated workflow object |\n| `list_executions`     | `status?`, `workflow_id?`, `project_id?`, `include_data?`, `limit?`, `cursor?`          | `{ data, nextCursor }`      |\n\nResponses are n8n's native JSON payloads, returned as `structuredContent`.\n\n### Listing and pagination\n\n`list_workflows` and `list_executions` are cursor-paginated: pass the\n`nextCursor` from a response as the `cursor` argument to fetch the next page.\n`limit` accepts 1-250 (default 100). `list_executions` filters by `status`\n(`canceled`, `crashed`, `error`, `new`, `running`, `success`, `unknown`,\n`waiting`), `workflow_id` or `project_id`.\n\n### Activating and deactivating\n\n`activate_workflow` starts a workflow's triggers; `deactivate_workflow` stops\nthem. Both take a `workflow_id` and return the updated workflow.\n\n## Develop\n\n```bash\npnpm --filter @bossforce.ai/mcp-n8n build\npnpm --filter @bossforce.ai/mcp-n8n test\n```\n\nRegenerate the tools/list snapshot after an intentional signature change:\n\n```bash\nUPDATE_SNAPSHOTS=1 pnpm --filter @bossforce.ai/mcp-n8n test\n```\n","readmeFilename":"README.md","_rev":"1-e1bae350b6e29484821d015ab4a380b3"}