MCPInstall
n8n-mcp-memory logo

n8n-mcp-memory

by ctkadvisors 1 stars ctkadvisors/n8n-mcp-memory

n8n-mcp-memory is an MCP server enabling AI assistants to interact with the n8n automation platform.

READMEmain

n8n Memory Control Panel (MCP)

CI Docker Build

A Model Context Protocol (MCP) server that provides AI assistants with access to n8n automation platform.

Features

  • Complete n8n API integration
  • Works with Claude Desktop and Augment
  • Supports all n8n resources: workflows, tags, credentials, users, projects, variables
  • Enables AI assistants to create, update, and execute n8n workflows

Quick Start

Using Docker

docker run -p 3000:3000 \
  -e N8N_API_URL=https://your-n8n-instance.com/api/v1 \
  -e N8N_API_KEY=your-n8n-api-key \
  -v n8n_mcp_cache:/app/cache \
  ghcr.io/ctkadvisors/n8n-mcp-memory:main

Local Development

# Clone the repository
git clone https://github.com/ctkadvisors/n8n-mcp-memory.git
cd n8n-mcp-memory

# Install dependencies
pnpm install

# Set environment variables
echo "N8N_API_URL=https://your-n8n-instance.com/api/v1" > .env
echo "N8N_API_KEY=your-n8n-api-key" >> .env

# Build and start the server
pnpm run build
pnpm run start:server

Integration with AI Assistants

Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcp": {
    "servers": {
      "n8n": {
        "endpoint": "http://localhost:3000/mcp"
      }
    }
  }
}

Augment (VS Code)

Option 1: Local Docker Container

Configure in Augment settings for local development:

"augment.advanced": {
  "mcpServers": [
    {
      "name": "n8n-mcp",
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "-p", "3000:3000",
        "-e", "N8N_API_URL=https://your-n8n-instance.com/api/v1",
        "-e", "N8N_API_KEY=your-n8n-api-key",
        "ghcr.io/ctkadvisors/n8n-mcp-memory:main"
      ]
    }
  ]
}

Option 2: Remote HTTP MCP Server (Recommended for Production)

If you have the MCP server running remotely (e.g., at https://n8n-mcp.knuteson.io/):

Method A: Using Augment UI

  1. Open Augment in VS Code
  2. Click "Add HTTP MCP"
  3. Configure:
    • Name: n8n-mcp-memory
    • URL: https://your-mcp-server-domain.com/mcp

Method B: Manual Configuration

"augment.advanced": {
  "mcpServers": [
    {
      "name": "n8n-mcp-memory",
      "endpoint": "https://your-mcp-server-domain.com/mcp"
    }
  ]
}

Verification Steps:

  1. Check server health: https://your-mcp-server-domain.com/api/health
  2. View capabilities: https://your-mcp-server-domain.com/api/capabilities
  3. Test in Augment: Ask "List my n8n workflows"

Resources and Tools

The server provides access to n8n resources through URI patterns:

  • n8n://workflows - List all workflows
  • n8n://tags - List all tags
  • n8n://executions - List all executions
  • n8n://users - List all users
  • n8n://projects - List all projects
  • n8n://variables - List all variables

And tools for performing actions:

  • Workflow management (create, update, delete, activate)
  • Tag management (create, update, delete)
  • Execution management (run workflows, delete executions)
  • Credential management (create, delete, transfer)
  • User management (create, delete, change roles)
  • Project management (create, update, delete)
  • Variable management (create, delete)
  • Source control integration (pull changes)
  • Security audit generation

License

MIT License with Attribution - see LICENSE file for details.