Log inSubmit server
Tcs N8n MCP logo

Tcs N8n MCP

by @thecodesaiyan

Manage n8n workflows, executions, tags, variables, credentials, and users through structured MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Tcs N8n MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "thecodesaiyan-tcs-n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@thecodesaiyan/tcs-n8n-mcp"
      ],
      "env": {
        "N8N_API_KEY": "YOUR_VALUE_HERE",
        "N8N_API_URL": "YOUR_VALUE_HERE",
        "N8N_AUTH_TYPE": "YOUR_VALUE_HERE",
        "N8N_API_USER": "YOUR_VALUE_HERE",
        "N8N_TIMEOUT_MS": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @thecodesaiyan/tcs-n8n-mcp

Process exited before answering initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked .

Overview

@thecodesaiyan/tcs-n8n-mcp connects MCP clients to supported parts of the n8n public API. It provides typed tools for creating and updating workflows, reviewing executions, organising tags, managing variables, and inspecting credential metadata and users. Authentication defaults to an n8n API key, with Bearer and Basic modes available for compatible deployments. Reach for it when an AI assistant needs controlled access to an n8n instance without exposing credential secrets.

Use cases

  • Create and update n8n workflows from an MCP client
  • Inspect workflow executions by status or workflow ID
  • Organise workflows with reusable tags
  • Review n8n users and credential metadata
  • Manage n8n environment variables without revealing listed values

Key features

  • 21 structured tools for n8n administration
  • Workflow creation, editing, activation, and deletion
  • Execution listing with workflow and status filters
  • Masked environment variable handling
  • Credential metadata access without secrets
  • API key, Bearer, and Basic authentication modes

Tools21

What Tcs N8n MCP lets your agent do. Expand a tool for its parameters.

Self-reported~339 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @thecodesaiyan/tcs-n8n-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads299Package downloads in the last 30 days.
Last commit26d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed21Callable tools this server registers over MCP.

How Tcs N8n MCP works

What @thecodesaiyan/tcs-n8n-mcp does

@thecodesaiyan/tcs-n8n-mcp exposes selected n8n public API operations as structured MCP tools. It covers workflow lifecycle management, execution records, tags, environment variables, credential metadata, and user information. The server is suited to MCP clients that need to inspect or administer an n8n instance from an AI-assisted development environment.

Workflow operations include listing, reading, creating, updating, activating, deactivating, and deleting workflows. Execution tools support filtered listing, retrieval, and deletion. Additional tools handle tag creation and renaming, variable changes, credential metadata listing, and user lookups.

How it works

The server runs as an MCP process and sends requests to an n8n instance over HTTP. It uses the n8n API key by default through the X-N8N-API-KEY header. Bearer authentication and Basic authentication can be selected for compatible proxies or deployments.

Responses are structured and bounded, with sanitised errors and request timeouts. Destructive operations require explicit confirmation. Workflow and execution retrieval is conservative by default: raw workflow fields and node execution data must be requested explicitly. Variable values are masked when listed, and credential tools return metadata rather than secrets.

Setup and configuration

Node.js 22.14 or newer and an n8n instance are required. The package can be started with npx @thecodesaiyan/tcs-n8n-mcp --setup; its wizard collects credentials, tests the connection, and can configure detected clients. On Windows, global installation may be needed before invoking the command because of scoped-package command resolution.

Set N8N_API_KEY to an n8n API key. N8N_API_URL points to the instance and defaults to http://localhost:5678; it may be the instance root or an address ending in /api/v1. N8N_AUTH_TYPE accepts apikey, bearer, or basic, while Basic authentication also uses N8N_API_USER. N8N_TIMEOUT_MS controls the request timeout and defaults to 30,000 milliseconds. The API URL must be an absolute HTTP(S) URL without embedded credentials, a query string, or a fragment.

Tools and capabilities

  • Work with workflows using list_workflows, get_workflow, create_workflow, update_workflow, activate_workflow, deactivate_workflow, and delete_workflow.
  • Inspect and remove executions with list_executions, get_execution, and delete_execution, including workflow ID and status filters when listing.
  • Organise workflows through list_tags, create_tag, update_tag, and delete_tag.
  • Manage environment variables with list_variables, create_variable, update_variable, and delete_variable.
  • Review credential metadata with list_credentials and inspect accounts with list_users and get_user.

Limitations and notes

The server covers supported portions of the n8n public API rather than every n8n operation. Credential secrets are never exposed, and listed variable values are masked. Raw workflow fields and node execution data are treated as untrusted and require opt-in parameters. Deleting workflows, executions, tags, or variables requires explicit confirmation.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Tcs N8n MCP

@thecodesaiyan/tcs-n8n-mcp is an MCP server that connects AI clients to the n8n public API. Its main tools manage workflows, executions, tags, variables, credential metadata, and users, while masking variable values and keeping credential secrets out of responses.

Run `npx @thecodesaiyan/tcs-n8n-mcp --setup` to start the configuration wizard. It collects the n8n credentials, checks the connection, and configures detected clients; Windows users may need a global npm installation first.

Set `N8N_API_KEY` and optionally configure `N8N_API_URL`, `N8N_AUTH_TYPE`, `N8N_API_USER`, and `N8N_TIMEOUT_MS`. The API URL defaults to `http://localhost:5678`, and Basic authentication requires `N8N_API_USER`.

Yes, Cursor is a supported client. Add the server to the global `~/.cursor/mcp.json` file or the project-level `.cursor/mcp.json`, using `npx` on macOS and Linux or the globally installed command on Windows.

No, credential tools return metadata only and never expose secrets. Environment variable listings also mask values, while raw workflow fields and node execution data require explicit opt-in.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewTcs N8n MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/thecodesaiyan-tcs-n8n-mcp?style=directory)](https://allmcps.com/mcp/thecodesaiyan-tcs-n8n-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/thecodesaiyan-tcs-n8n-mcp"><img src="https://allmcps.com/api/badge/thecodesaiyan-tcs-n8n-mcp?style=directory" alt="Tcs N8n MCP on AllMCPs" /></a>