# @thecodesaiyan/tcs-n8n-mcp [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/ntatschner/tcs-n8n-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 299  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/thecodesaiyan-tcs-n8n-mcp

## Description
MCP server for n8n workflow automation. Manage workflows, executions, tags, variables, credentials and users via the Model Context Protocol.

## Tools
Capabilities this server exposes over MCP:

- **list_workflows** — List all workflows with pagination
- **get_workflow** — Get safe workflow metadata; set `includeRawData: true` to opt into untrusted raw fields
- **create_workflow** — Create a new workflow with optional nodes and connections
- **update_workflow** — Update an existing workflow's name, nodes, connections, or settings
- **delete_workflow** — Permanently delete a workflow after explicit confirmation
- **activate_workflow** — Activate a workflow so it runs on its configured triggers
- **deactivate_workflow** — Deactivate a workflow to stop trigger-based execution
- **list_executions** — List executions with optional filters for workflow ID and status
- **get_execution** — Get safe execution metadata; `includeData: true` opts into untrusted node data
- **delete_execution** — Delete an execution record after explicit confirmation
- **list_tags** — List all tags used for organising workflows
- **create_tag** — Create a new tag
- **update_tag** — Rename an existing tag
- **delete_tag** — Delete a tag after explicit confirmation
- **list_variables** — List all environment variables (values are masked for security)
- **create_variable** — Create a new key-value environment variable
- **update_variable** — Update an existing variable's key or value
- **delete_variable** — Delete an environment variable after explicit confirmation
- **list_credentials** — List all credentials (metadata only — secrets are never exposed)
- **list_users** — List all users with their roles and status
- **get_user** — Get full details of a user by ID

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "tcs-n8n-mcp": {
    "command": "npx",
    "args": ["-y","@thecodesaiyan/tcs-n8n-mcp"],
    "env": {
      "N8N_API_KEY": "",
      "N8N_API_URL": "",
      "N8N_AUTH_TYPE": "",
      "N8N_API_USER": "",
      "N8N_TIMEOUT_MS": ""
    }
  }
}
```

**Requires environment variables:** `N8N_API_KEY`, `N8N_API_URL`, `N8N_AUTH_TYPE`, `N8N_API_USER`, `N8N_TIMEOUT_MS` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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.

_Full upstream README: https://allmcps.com/mcp/thecodesaiyan-tcs-n8n-mcp/readme_