MCP N8n

Delete one execution history record by ID. Irreversible: the run log is removed and the workflow itself is kept. Call n8n_get_execution first if you still need the error or output. Returns the deletion result.

Delete a project by id. Irreversible. Workflows and credentials in it can become inaccessible; this tool does not export them. Call n8n_export_all_workflows first if you need a copy, and n8n_list_projects to confirm the id. Returns the deletion result. Requires permission to delete that project.

Delete a tag by id. Workflows lose that tag; the workflows themselves are not deleted. Irreversible. Call n8n_list_tags to confirm the id. Returns the deletion result.

Delete a user by id. Owner only. Irreversible: the account is removed. Workflows are not deleted by this tool. Call n8n_list_users to confirm the id. Returns the deletion result.

Delete an environment variable.

Delete a workflow permanently. A local snapshot is saved first so it can be restored with n8n_rollback_workflow (into a new workflow).

Compare a workflow snapshot against the current state (or another snapshot): nodes added/removed/modified, changed parameters, and connection changes. Useful before deciding whether to roll back.

Back up every workflow of the instance as individual JSON files in a local directory. Complements the per-change snapshots with a full-instance safety net.

Generate the instance security audit. Read-only: it does not change workflows, credentials, or users. Returns the report sections from the n8n audit API. Requires an owner or admin API key. Use this instead of guessing security issues from workflow JSON.

Get the schema for a credential type to understand required fields.

Get detailed information about a specific execution.

Get the real parameter schema of an n8n node type: parameters with types, options and display conditions, required params, credentials, latest typeVersion, plus curated notes and an example for common nodes.

Inspect the data that flowed through a specific node in an execution, without downloading the whole execution. Without nodeName, returns an overview of all executed nodes (status, item counts, errors). With nodeName, returns the actual output items (limited sample) and error details for that node.

Get information about a specific tag.

Get user by ID or email (owner only).

Get one workflow by ID, including its nodes, connections, and settings. Read-only. Use this after n8n_list_workflows_summary when you need the full definition of a single workflow. Returns the workflow object, or an error if the ID does not exist.

Get all tags associated with a workflow.

Get a specific workflow template by ID or intelligently find the best matching template based on user requirements.

Download an official n8n.io template by ID and create it as a workflow in this instance. Credentials still have to be attached in n8n.

Import workflow JSON files from a local directory (e.g. a backup created with n8n_export_all_workflows) as new workflows in the instance.

List workflow executions. Can filter by status, workflow ID, or project. TIP: Set includeData=false and use fields parameter to reduce token usage.

List projects visible to this API key. Read-only. Returns id, name, and type for each project, without workflow contents. Use an id with n8n_update_project, n8n_delete_project, or the transfer tools.

List all tags available in n8n.

List all users (owner only).

List environment variables. Read-only. Optional projectId and state narrow the list. Returns id, key, value, and type. Does not create or change variables; use n8n_create_variable or n8n_update_variable for that.

List local snapshots of a workflow. A snapshot is saved automatically before every update, partial update, or delete done through this server.

List available workflow templates with their metadata. Use this to discover what pre-built workflows are available.

List all workflows with full details. Can filter by active status, tags, name, or project. WARNING: Returns complete workflow data including nodes and connections - use n8n_list_workflows_summary for better token efficiency.

List workflows with minimal data (id, name, active, tags, updatedAt only). Recommended for browsing and listing - uses 90% fewer tokens than n8n_list_workflows. Use n8n_get_workflow to fetch full details of a specific workflow.

Pull the Git repository connected in n8n and apply it to this instance. Workflows that differ from the remote can be overwritten. This is not a local backup (n8n_export_all_workflows) and not a snapshot restore (n8n_rollback_workflow). Fails if source control is not configured. Returns the pull result. Requires permission to use source control.

Remove a user from one project. They lose access to that project only; the account and other projects stay. To undo it, call n8n_add_user_to_project again. Returns the removal result. Requires permission to manage that project.

Retry a failed execution by ID, starting a new run when n8n allows it. Does not edit the workflow. Use n8n_debug_last_error first if you need the failing node. Fails when the execution cannot be retried. Returns the new execution.

Restore a workflow to a previous snapshot (latest by default). The current state is snapshotted first, so a rollback can itself be undone. If the workflow was deleted, set recreate=true to restore it as a new workflow.

Search the full catalog of 560 n8n nodes (extracted from the real n8n packages). Use this BEFORE creating a workflow so node types are correct. Returns summaries; use n8n_get_node for the full parameter schema.

Search official n8n.io workflow templates (thousands, always current). Returns summaries only. Then use n8n_import_public_template to copy one into the instance.

Move a credential to another project. It leaves the source project; this is not a copy, so workflows there lose access to it. Use n8n_list_projects for destinationProjectId. Returns the transfer result. Requires access to both projects.

Move a workflow to another project. It leaves the source project; this is not a copy and nodes are not changed. Credentials may stay behind. Use n8n_list_projects for destinationProjectId. Returns the transfer result. Requires access to both projects.

Call a Webhook-trigger workflow on the n8n instance to test it end-to-end and see the real response. Use test=true only while the workflow is in "Listen for test event" mode in the editor; otherwise the workflow must be active.

Rename a project or change its type between team and personal. Only fields you send are changed; omitted fields stay as they are. Call n8n_list_projects for the id. Does not move workflows or change members. Sending the current name and type again leaves the project unchanged. Returns the updated project. Requires permission to edit that project.

Rename a tag. The id stays the same, so workflows that already use it keep the tag. Call n8n_list_tags for the id. A name that already exists is rejected. Returns the updated tag.

Update an environment variable.

Update an existing workflow. Supports partial updates: omitted fields keep their current values (the current workflow is fetched and merged automatically).

Apply surgical edits to an existing workflow without rewriting it. Operations: setName, addNode, removeNode, updateNode, addConnection, removeConnection. Fetches the current workflow, applies the ops, and saves.

Replace the entire tag set of one workflow with tagIds. Tags omitted from the array are removed from that workflow; nodes are not changed. Call n8n_list_tags to resolve names to IDs and n8n_get_workflow_tags to see the current set first. Sending the same IDs again leaves the tags unchanged. Returns the updated tag list. Requires permission to edit the workflow.

Validate a workflow JSON before creating or updating it. Checks node names, types, required parameters, and connections. Always call this before n8n_create_workflow or n8n_activate_workflow.

Operational health report computed from recent executions: success rate, failure count, average duration, and last failure per workflow, sorted worst-first. Use it to find which workflows need attention.