How should n8n-mcp-server be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this mcp.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Crawler Summary

n8n-mcp-server answer-first brief

MCP server for N8N workflow automation N8N MCP Server Model Context Protocol (MCP) server for n8n workflow automation. This server allows AI assistants like Claude to create, manage, and execute n8n workflows programmatically. Features - Create workflows with nodes and connections - List all workflows - Get workflow details - Activate/deactivate workflows - Execute workflows manually - View execution history - Update existing workflows - Delete workflows Published capability contract available. No trust telemetry is available yet. Last updated 2/24/2026.

Freshness

Last checked 2/22/2026

Best For

Contract is available with explicit auth and schema references.

Not Ideal For

n8n-mcp-server is not ideal for teams that need stronger public trust telemetry, lower setup complexity, or more explicit contract coverage before production rollout.

Evidence Sources Checked

editorial-content, capability-contract, runtime-metrics, public facts pack

Card Facts Snapshot Contract Trust

Claim this agent

Agent DossierGitHubSafety: 98/100

n8n-mcp-server

MCPverified

Public facts

Change events

Artifacts

Freshness

Feb 22, 2026

Verifiededitorial-content1 verified compatibility signal

Published capability contract available. No trust telemetry is available yet. Last updated 2/24/2026.

Schema refs publishedTrust evidence available

Trust score

Unknown

Compatibility

MCP

Freshness

Feb 22, 2026

Vendor

Imthebreezy247

Artifacts

Benchmarks

Last release

1.0.0

Executive Summary

Key links, install path, and a quick operational read before the deeper crawl record.

Verifiededitorial-content

Summary

Published capability contract available. No trust telemetry is available yet. Last updated 2/24/2026.

View Source

Setup snapshot

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

1
Setup complexity is MEDIUM. Standard integration tests and API key provisioning are required before connecting this to production workloads.
2
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence Ledger

Everything public we have scraped or crawled about this agent, grouped by evidence type with provenance.

Verifiededitorial-content

Vendor (1)

Vendor

Imthebreezy247

profilemedium

Observed Feb 24, 2026Source link Provenance

Compatibility (2)

Protocol compatibility

MCP

contracthigh

Observed Feb 24, 2026Source link Provenance

Auth modes

mcp, api_key

contracthigh

Observed Feb 24, 2026Source link Provenance

Artifact (1)

Machine-readable schemas

OpenAPI or schema references published

contracthigh

Observed Feb 24, 2026Source link Provenance

Security (1)

Handshake status

UNKNOWN

trustmedium

Observed unknownSource link Provenance

Integration (1)

Crawlable docs

6 indexed pages on the official domain

search_documentmedium

Observed Apr 15, 2026Source link Provenance

Release & Crawl Timeline

Merged public release, docs, artifact, benchmark, pricing, and trust refresh events.

Self-declaredagent-index

Docs Update

Docs refreshed: Sign in to GitHub · GitHub

search_documentmedium

Fresh crawlable documentation was indexed for the official domain.

Observed Apr 15, 2026

Artifacts Archive

Extracted files, examples, snippets, parameters, dependencies, permissions, and artifact metadata.

Self-declaredGITHUB MCP

Extracted files

Examples

Snippets

Languages

typescript

Executable Examples

bash

npm install
npm run build

env

N8N_URL=https://cshannahan.app.n8n.cloud
N8N_API_KEY=your_api_key_here

bash

node build/index.js

json

{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": ["c:\\Coding-projects\\n8n-mcp-server\\build\\index.js"],
      "env": {
        "N8N_URL": "https://cshannahan.app.n8n.cloud",
        "N8N_API_KEY": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJkNjljMjhhYi1iNTI2LTQ3NTItYjk5My00ZWJlOGE0MDgyNzEiLCJpc3MiOiJuOG4iLCJhdWQiOiJwdWJsaWMtYXBpIiwiaWF0IjoxNzYyNjM4ODIzLCJleHAiOjE3NzAzNTQwMDB9.HArBOezj-BCNPH1dHtM-At2TE5wAdLnDbV3gpnXmK3k"
      }
    }
  }
}

bash

node test-connection.js

bash

npm run build

Docs & README

Full documentation captured from public sources, including the complete README when available.

Self-declaredGITHUB MCP

Docs source

GITHUB MCP

Editorial quality

ready

Full README

N8N MCP Server

Model Context Protocol (MCP) server for n8n workflow automation. This server allows AI assistants like Claude to create, manage, and execute n8n workflows programmatically.

Features

Create workflows with nodes and connections
List all workflows
Get workflow details
Activate/deactivate workflows
Execute workflows manually
View execution history
Update existing workflows
Delete workflows

Installation

npm install
npm run build

Configuration

The server requires two environment variables:

N8N_URL - Your n8n instance URL (e.g., https://yourdomain.app.n8n.cloud)
N8N_API_KEY - Your n8n API key

Getting Your N8N API Key

Log into your n8n instance
Go to Settings → API
Create a new API key
Copy the JWT token

Usage

Method 1: Direct Execution

Create a .env file:

N8N_URL=https://cshannahan.app.n8n.cloud
N8N_API_KEY=your_api_key_here

Run the server:

node build/index.js

Method 2: Claude Desktop Integration

Add to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "n8n": {
      "command": "node",
      "args": ["c:\\Coding-projects\\n8n-mcp-server\\build\\index.js"],
      "env": {
        "N8N_URL": "https://cshannahan.app.n8n.cloud",
        "N8N_API_KEY": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJkNjljMjhhYi1iNTI2LTQ3NTItYjk5My00ZWJlOGE0MDgyNzEiLCJpc3MiOiJuOG4iLCJhdWQiOiJwdWJsaWMtYXBpIiwiaWF0IjoxNzYyNjM4ODIzLCJleHAiOjE3NzAzNTQwMDB9.HArBOezj-BCNPH1dHtM-At2TE5wAdLnDbV3gpnXmK3k"
      }
    }
  }
}

Important: Replace your_api_key_here with your actual n8n API key.

Troubleshooting

401 Unauthorized Error

If you get 401 unauthorized errors when using the MCP:

Check API Key: Ensure your API key is correct and hasn't expired
Check Environment Variables: Make sure N8N_API_KEY is set in the MCP configuration
Test Connection: Run the direct API test:
```
node test-connection.js
```
Check URL: Ensure N8N_URL doesn't have a trailing slash

Common Issues

Empty API Key: If the environment variable isn't set, the server will use an empty string and fail authentication
Wrong URL Format: The URL should be just the base URL without /api/v1 (the server adds this automatically)
Expired API Key: n8n API keys can expire - generate a new one if needed

Available Tools

create_workflow

Create a new n8n workflow with nodes and connections.

Parameters:

name (string): Workflow name
nodes (array): Array of node configurations
connections (object): Node connections

list_workflows

List all workflows in your n8n instance.

Parameters:

active (boolean, optional): Filter by active status

get_workflow

Get detailed information about a specific workflow.

Parameters:

workflow_id (string): The workflow ID

activate_workflow

Activate or deactivate a workflow.

Parameters:

workflow_id (string): The workflow ID
active (boolean): True to activate, false to deactivate

execute_workflow

Manually trigger a workflow execution.

Parameters:

workflow_id (string): The workflow ID
data (object, optional): Input data for the workflow

get_executions

Get execution history for workflows.

Parameters:

workflow_id (string, optional): Filter by workflow ID
limit (number): Number of executions to return (default: 10)

update_workflow

Update an existing workflow's configuration.

Parameters:

workflow_id (string): The workflow ID to update
name (string, optional): New workflow name
nodes (array, optional): Updated node configurations
connections (object, optional): Updated connections

delete_workflow

Delete a workflow permanently.

Parameters:

workflow_id (string): The workflow ID to delete

Example: Viral Movie Clips Automation

A complete workflow has been created at: Workflow ID: UmlJ5iLjZrXdEMH6

URL: https://cshannahan.app.n8n.cloud/workflow/UmlJ5iLjZrXdEMH6

This workflow:

Runs every 4 hours
Fetches trending movies from Reddit and TMDB
Calculates viral potential scores
Generates clip ideas with hashtags
Ranks content by priority (high/medium/low)

Development

Edit src/index.ts and rebuild:

npm run build

For development with auto-rebuild:

npm run dev

License

MIT

Contract & API

Machine endpoints, protocol fit, contract coverage, invocation examples, and guardrails for agent-to-agent use.

Verifiedcapability-contract

Endpoints

Dossier API Snapshot API Contract API Trust API

Contract coverage

Status

ready

Auth

mcp, api_key

Streaming

Data region

global

Protocol support

MCP: verified

Requires: mcp, lang:typescript

Forbidden: none

Guardrails

Operational confidence: medium

Contract is available with explicit auth and schema references.

Trust confidence is not low and verification freshness is acceptable.

Protocol support is explicitly confirmed in contract metadata.

Invocation examples

curl -s "https://www.xpersona.co/api/v1/agents/mcp-imthebreezy247-n8n-mcp-server/snapshot"

curl -s "https://www.xpersona.co/api/v1/agents/mcp-imthebreezy247-n8n-mcp-server/contract"

curl -s "https://www.xpersona.co/api/v1/agents/mcp-imthebreezy247-n8n-mcp-server/trust"

Reliability & Benchmarks

Trust and runtime signals, benchmark suites, failure patterns, and practical risk constraints.

Missingruntime-metrics

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

No benchmark suites or observed failure patterns are available.

Media & Demo

Every public screenshot, visual asset, demo link, and owner-provided destination tied to this agent.

Missingno-media

No screenshots, media assets, or demo links are available.

Related Agents

Neighboring agents from the same protocol and source ecosystem for comparison and shortlist building.

Self-declaredprotocol-neighbors

Gitlab Ai CatalogUpdated 1h agoRank 86

gitlab-mcp

A Model Context Protocol (MCP) server for GitLab

MCPAImcpmodel-context-protocol

Gitlab Public ProjectsUpdated 1h agoRank 83

gitlab-mcp

A Model Context Protocol (MCP) server for GitLab

MCPAImcpmodel-context-protocol

Zapier Agent TemplatesUpdated 1h agoRank 76

Viral Content Creation Agent

This agent researches trends, scripts videos, sets up engagement automation, and compiles everything into a shareable document.

MCPagentassistantautomation

Zapier Agent TemplatesUpdated 1h agoRank 76

Reddit Trend Content Generator by Kiran Shahid

This agent analyzes Reddit data to generate trending content concepts tailored to your audience.

MCPagentassistantautomation

Machine Appendix

Contract JSON

{
  "contractStatus": "ready",
  "authModes": [
    "mcp",
    "api_key"
  ],
  "requires": [
    "mcp",
    "lang:typescript"
  ],
  "forbidden": [],
  "supportsMcp": true,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": "https://github.com/imthebreezy247/n8n-mcp-server#input",
  "outputSchemaRef": "https://github.com/imthebreezy247/n8n-mcp-server#output",
  "dataRegion": "global",
  "contractUpdatedAt": "2026-02-24T19:46:13.908Z",
  "sourceUpdatedAt": "2026-02-24T19:46:13.908Z",
  "freshnessSeconds": 19550438
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://www.xpersona.co/api/v1/agents/mcp-imthebreezy247-n8n-mcp-server/snapshot",
    "contractUrl": "https://www.xpersona.co/api/v1/agents/mcp-imthebreezy247-n8n-mcp-server/contract",
    "trustUrl": "https://www.xpersona.co/api/v1/agents/mcp-imthebreezy247-n8n-mcp-server/trust"
  },
  "curlExamples": [
    "curl -s \"https://www.xpersona.co/api/v1/agents/mcp-imthebreezy247-n8n-mcp-server/snapshot\"",
    "curl -s \"https://www.xpersona.co/api/v1/agents/mcp-imthebreezy247-n8n-mcp-server/contract\"",
    "curl -s \"https://www.xpersona.co/api/v1/agents/mcp-imthebreezy247-n8n-mcp-server/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "MCP"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "GITHUB_MCP",
      "generatedAt": "2026-10-09T02:26:52.242Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "MCP",
      "type": "protocol",
      "support": "supported",
      "confidenceSource": "contract",
      "notes": "Confirmed by capability contract"
    },
    {
      "key": "n8n",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "mcp",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "automation",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    }
  ],
  "flattenedTokens": "protocol:MCP|supported|contract capability:n8n|supported|profile capability:mcp|supported|profile capability:automation|supported|profile"
}

Facts JSON

[
  {
    "factKey": "docs_crawl",
    "category": "integration",
    "label": "Crawlable docs",
    "value": "6 indexed pages on the official domain",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "MCP",
    "href": "https://www.xpersona.co/api/v1/agents/mcp-imthebreezy247-n8n-mcp-server/contract",
    "sourceUrl": "https://www.xpersona.co/api/v1/agents/mcp-imthebreezy247-n8n-mcp-server/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:13.908Z",
    "isPublic": true
  },
  {
    "factKey": "auth_modes",
    "category": "compatibility",
    "label": "Auth modes",
    "value": "mcp, api_key",
    "href": "https://www.xpersona.co/api/v1/agents/mcp-imthebreezy247-n8n-mcp-server/contract",
    "sourceUrl": "https://www.xpersona.co/api/v1/agents/mcp-imthebreezy247-n8n-mcp-server/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:13.908Z",
    "isPublic": true
  },
  {
    "factKey": "schema_refs",
    "category": "artifact",
    "label": "Machine-readable schemas",
    "value": "OpenAPI or schema references published",
    "href": "https://github.com/imthebreezy247/n8n-mcp-server#input",
    "sourceUrl": "https://www.xpersona.co/api/v1/agents/mcp-imthebreezy247-n8n-mcp-server/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:13.908Z",
    "isPublic": true
  },
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "Imthebreezy247",
    "href": "https://github.com/imthebreezy247/n8n-mcp-server",
    "sourceUrl": "https://github.com/imthebreezy247/n8n-mcp-server",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-02-24T19:43:14.176Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://www.xpersona.co/api/v1/agents/mcp-imthebreezy247-n8n-mcp-server/trust",
    "sourceUrl": "https://www.xpersona.co/api/v1/agents/mcp-imthebreezy247-n8n-mcp-server/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "eventType": "docs_update",
    "title": "Docs refreshed: Sign in to GitHub · GitHub",
    "description": "Fresh crawlable documentation was indexed for the official domain.",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  }
]