Skip to content
Back to search

n8n-mcp-server

MCP server implementation for n8n workflow automation

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/illuminaresolutions--n8n-mcp-server/badge.svg)](/listings/illuminaresolutions--n8n-mcp-server)

HTML

<a href="/listings/illuminaresolutions--n8n-mcp-server"><img src="/api/listings/illuminaresolutions--n8n-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Get your n8n API Key

1. Log into your n8n instance 2. Click your user icon in the bottom left 3. Go to Settings 4. Select API 5. Click "Create API Key" 6. Copy your API key (you won't be able to see it again)

Install the MCP Server

Option 1: Install from npm (Recommended)

npm install -g @illuminaresolutions/n8n-mcp-server

Option 2: Install from Source

1. Clone the repository:

   git clone https://github.com/illuminaresolutions/n8n-mcp-server.git
   cd n8n-mcp-server

2. Install dependencies and build:

   npm install
   npm run build

3. Start the server in the background:

   nohup npm start > n8n-mcp.log 2>&1 &

To stop the server:

   pkill -f "node build/index.js"

Note: When installing from npm, the server will be available as `n8n-mcp-server` in your PATH.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 174 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # n8n MCP Server
  2. An MCP server that provides access to n8n workflows, executions, credentials, and more through the Model Context Protocol. This allows Large Language Models (LLMs) to interact with n8n instances in a secure and standardized way.
  3. ## Installation
  4. ### Get your n8n API Key
  5. 1. Log into your n8n instance
  6. 2. Click your user icon in the bottom left
  7. 3. Go to Settings
  8. 4. Select API
  9. 5. Click "Create API Key"
  10. 6. Copy your API key (you won't be able to see it again)
  11. ### Install the MCP Server
  12. #### Option 1: Install from npm (Recommended)
  13. ```bash
  14. npm install -g @illuminaresolutions/n8n-mcp-server
  15. ```
  16. #### Option 2: Install from Source
  17. 1. Clone the repository:
  18. ```bash
  19. git clone https://github.com/illuminaresolutions/n8n-mcp-server.git
  20. cd n8n-mcp-server
  21. ```
  22. 2. Install dependencies and build:
  23. ```bash
  24. npm install
  25. npm run build
  26. ```
  27. 3. Start the server in the background:
  28. ```bash
  29. nohup npm start > n8n-mcp.log 2>&1 &
  30. ```
  31. To stop the server:
  32. ```bash
  33. pkill -f "node build/index.js"
  34. ```
  35. Note: When installing from npm, the server will be available as `n8n-mcp-server` in your PATH.
  36. ## Configuration
  37. ### Claude Desktop
  38. 1. Open your Claude Desktop configuration:
  39. ```
  40. ~/Library/Application Support/Claude/claude_desktop_config.json
  41. ```
  42. 2. Add the n8n configuration:
  43. ```json
  44. {
  45. "mcpServers": {
  46. "n8n": {
  47. "command": "n8n-mcp-server",
  48. "env": {
  49. "N8N_HOST": "https://your-n8n-instance.com",
  50. "N8N_API_KEY": "your-api-key-here"
  51. }
  52. }
  53. }
  54. }
  55. ```
  56. ### Cline (VS Code)
  57. 1. Install the server (follow Installation steps above)
  58. 2. Open VS Code
  59. 3. Open the Cline extension from the left sidebar
  60. 4. Click the 'MCP Servers' icon at the top of the pane
  61. 5. Scroll to bottom and click 'Configure MCP Servers'
  62. 6. Add to the opened settings file:
  63. ```json
  64. {
  65. "mcpServers": {
  66. "n8n": {
  67. "command": "n8n-mcp-server",
  68. "env": {
  69. "N8N_HOST": "https://your-n8n-instance.com",
  70. "N8N_API_KEY": "your-api-key-here"
  71. }
  72. }
  73. }
  74. }
  75. ```
  76. 7. Save the file
  77. 8. Ensure the MCP toggle is enabled (green) and the status indicator is green
  78. 9. Start using MCP commands in Cline
  79. ### Sage
  80. Coming soon! The n8n MCP server will be available through:
  81. - Smithery.ai marketplace
  82. - Import from Claude Desktop
  83. For now, please use Claude Desktop or Cline.
  84. ## Validation
  85. After configuration:
  86. 1. Restart your LLM application
  87. 2. Ask: "List my n8n workflows"
  88. 3. You should see your workflows listed
  89. If you get an error:
  90. - Check that your n8n instance is running
  91. - Verify your API key has correct permissions
  92. - Ensure N8N_HOST has no trailing slash
  93. ## Features
  94. ### Core Features
  95. - List and manage workflows
  96. - View workflow details
  97. - Execute workflows
  98. - Manage credentials
  99. - Handle tags and executions
  100. - Generate security audits
  101. - Manage workflow tags
  102. ### Enterprise Features
  103. These features require an n8n Enterprise license:
  104. - Project management
  105. - Variable management
  106. - Advanced user management
  107. ## Troubleshooting
  108. ### Common Issues
  109. 1. "Client not initialized"
  110. - Check N8N_HOST and N8N_API_KEY are set correctly
  111. - Ensure n8n instance is accessible
  112. - Verify API key permissions
  113. 2. "License required"
  114. - You're trying to use an Enterprise feature
  115. - Either upgrade to n8n Enterprise or use core features only
  116. 3. Connection Issues
  117. - Verify n8n instance is running
  118. - Check URL protocol (http/https)
  119. - Remove trailing slash from N8N_HOST
  120. ## Security Best Practices
  121. 1. API Key Management
  122. - Use minimal permissions necessary
  123. - Rotate keys regularly
  124. - Never commit keys to version control
  125. 2. Instance Access
  126. - Use HTTPS for production
  127. - Enable n8n authentication
  128. - Keep n8n updated
  129. ## Support
  130. - [GitHub Issues](https://github.com/illuminaresolutions/n8n-mcp-server/issues)
  131. - [n8n Documentation](https://docs.n8n.io)
  132. ## License
  133. [MIT License](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.