n8n MCP Server

List all workflows in the n8n instance with optional filtering.

Args:

• active (boolean, optional): Filter by active status

• tags (string, optional): Filter by tag IDs (comma-separated)

• name (string, optional): Filter by name (partial match)

• projectId (string, optional): Filter by project ID

• limit (number): Maximum results (default: 100, max: 250)

• cursor (string, optional): Pagination cursor from previous response

Returns: List of workflows with id, name, active status, created/updated timestamps, and tags. Includes nextCursor for pagination if more results exist.

Get full details of a specific workflow including all nodes and connections.

Args:

• id (string): The workflow ID

Returns: Complete workflow object with:

• name, id, active status

• nodes array with all node configurations

• connections mapping

• settings

• tags

• timestamps

Create a new workflow in n8n.

Args:

• name (string): Workflow name (required)

• nodes (array): Array of node objects, each with:

  • name (string): Node display name

  • type (string): Node type (e.g., "n8n-nodes-base.httpRequest")

  • position ([x, y]): Canvas position

  • parameters (object): Node-specific parameters

  • credentials (object, optional): Credential mappings

• connections (object): Node connections mapping

• settings (object, optional): Workflow settings

• tags (array, optional): Tag IDs to associate

Returns: The created workflow with its assigned ID.

Example node types:

• n8n-nodes-base.manualTrigger - Manual trigger

• n8n-nodes-base.scheduleTrigger - Scheduled trigger

• n8n-nodes-base.webhook - Webhook trigger

• n8n-nodes-base.httpRequest - HTTP Request

• n8n-nodes-base.code - Custom JavaScript/Python

• n8n-nodes-base.set - Set data

• n8n-nodes-base.if - Conditional

• n8n-nodes-base.merge - Merge data

Update an existing workflow. Can update name, nodes, connections, settings, or tags.

⚠️ IMPORTANT: When updating nodes or connections, you must provide the COMPLETE arrays. Partial updates are not supported - the provided values will replace existing ones.

Args:

• id (string): Workflow ID to update (required)

• name (string, optional): New workflow name

• nodes (array, optional): Complete updated nodes array

• connections (object, optional): Complete updated connections

• settings (object, optional): Updated settings

• tags (array, optional): Updated tag IDs

Returns: The updated workflow object.

Permanently delete a workflow.

⚠️ WARNING: This action cannot be undone!

Args:

• id (string): Workflow ID to delete

Returns: Confirmation of deletion.

Activate a workflow so it can run automatically based on its triggers.

Args:

• id (string): Workflow ID to activate

Returns: The activated workflow.

Deactivate a workflow to stop it from running automatically.

Args:

• id (string): Workflow ID to deactivate

Returns: The deactivated workflow.

Execute a workflow manually with optional input data.

Args:

• id (string): Workflow ID to run

• data (object, optional): Input data to pass to the workflow's first node

Returns: Execution result with:

• executionId: ID of this execution

• status: Current status

• data: Output data from the workflow

Update the tags associated with a workflow.

Args:

• id (string): Workflow ID

• tags (array): Array of tag objects with 'id' property

Returns: The updated workflow with new tags.

List workflow executions with optional filtering.

Args:

• workflowId (string, optional): Filter by workflow ID

• status (string, optional): Filter by status (error, success, waiting, new, running, canceled, crashed)

• includeData (boolean): Include full execution data (default: false)

• projectId (string, optional): Filter by project ID

• limit (number): Maximum results (default: 100)

• cursor (string, optional): Pagination cursor

Returns: List of executions with id, workflowId, status, mode, timestamps.

Get detailed information about a specific execution.

Args:

• id (string): Execution ID

• includeData (boolean): Include full execution data with node outputs (default: true)

Returns: Complete execution details including:

• Status and mode

• Timestamps (started, stopped)

• Workflow data

• Node execution results (if includeData is true)

Delete a specific execution by ID.

⚠️ WARNING: This action cannot be undone!

Args:

• id (string): Execution ID to delete

Returns: Confirmation of deletion.

Delete multiple executions based on filters.

⚠️ WARNING: This action cannot be undone! Use with caution.

Args:

• workflowId (string, optional): Delete executions for this workflow

• status (string, optional): Delete executions with this status

• deleteBefore (string, optional): Delete executions before this date (ISO 8601 format)

• ids (array, optional): Specific execution IDs to delete

Returns: Count of deleted executions.

Stop a running execution.

Args:

• id (string): Execution ID to stop

Returns: The stopped execution details.

Retry a failed execution.

Args:

• id (string): Execution ID to retry

Returns: The new execution created from the retry.

List all credentials (without sensitive data).

Args:

• type (string, optional): Filter by credential type (e.g., "slackApi", "httpBasicAuth")

• limit (number): Maximum results (default: 100)

• cursor (string, optional): Pagination cursor

Returns: List of credentials with id, name, type, and timestamps. ⚠️ Credential data/secrets are NOT included for security.

Get details of a specific credential (without sensitive data).

Args:

• id (string): Credential ID

Returns: Credential metadata (id, name, type, timestamps). ⚠️ Credential data/secrets are NOT returned for security.

Create a new credential.

Args:

• name (string): Credential name

• type (string): Credential type (use n8n_get_credential_schema to see required fields)

• data (object): Credential data (fields depend on type)

Common credential types:

• slackApi: { accessToken }

• httpBasicAuth: { user, password }

• httpHeaderAuth: { name, value }

• oAuth2Api: { clientId, clientSecret, ... }

• gmailOAuth2Api: OAuth credentials for Gmail

• notionApi: { apiKey }

• openAiApi: { apiKey }

Use n8n_get_credential_schema to get the exact fields required for a type.

Returns: The created credential (without sensitive data).

Update an existing credential.

Args:

• id (string): Credential ID to update

• name (string, optional): New credential name

• data (object, optional): Updated credential data

Returns: The updated credential (without sensitive data).

Delete a credential.

⚠️ WARNING: This will break any workflows using this credential!

Args:

• id (string): Credential ID to delete

Returns: Confirmation of deletion.

Get the schema/fields required for a credential type.

Args:

• credentialType (string): The credential type (e.g., "slackApi", "httpBasicAuth")

Returns: JSON schema showing required and optional fields for the credential type.

Use this before creating credentials to know what data fields are needed.

Transfer a credential to a different project.

Args:

• credentialId (string): Credential ID to transfer

• destinationProjectId (string): Target project ID

Returns: Confirmation of transfer.

List all tags available for organizing workflows.

Args:

• limit (number): Maximum results (default: 100)

• cursor (string, optional): Pagination cursor

Returns: List of tags with id and name.

Get details of a specific tag.

Args:

• id (string): Tag ID

Returns: Tag details with id and name.

Create a new tag for organizing workflows.

Args:

• name (string): Tag name (max 24 characters)

Returns: The created tag.

Rename an existing tag.

Args:

• id (string): Tag ID to update

• name (string): New tag name (max 24 characters)

Returns: The updated tag.

Delete a tag.

Args:

• id (string): Tag ID to delete

Returns: Confirmation of deletion.

List all environment variables.

Variables are accessible in workflows using $vars.variableName syntax.

Args:

• limit (number): Maximum results (default: 100)

• cursor (string, optional): Pagination cursor

Returns: List of variables with id, key, and value.

Get a specific variable by ID.

Args:

• id (string): Variable ID

Returns: Variable details with id, key, and value.

Create a new environment variable.

Variables can be used in workflows with $vars.variableName syntax.

Args:

• key (string): Variable key (alphanumeric + underscore, must start with letter or underscore)

• value (string): Variable value

Returns: The created variable.

Update an existing variable.

Args:

• id (string): Variable ID to update

• key (string, optional): New variable key

• value (string, optional): New variable value

Returns: The updated variable.

Delete a variable.

⚠️ WARNING: Workflows using this variable will break!

Args:

• id (string): Variable ID to delete

Returns: Confirmation of deletion.

List all projects.

Projects help organize workflows and credentials into separate workspaces.

Args:

• limit (number): Maximum results (default: 100)

• cursor (string, optional): Pagination cursor

Returns: List of projects with id, name, and type (personal/team).

Get details of a specific project.

Args:

• id (string): Project ID

Returns: Project details with id, name, and type.

Create a new project for organizing workflows and credentials.

Args:

• name (string): Project name

Returns: The created project.

Rename a project.

Args:

• id (string): Project ID to update

• name (string): New project name

Returns: The updated project.

Delete a project.

⚠️ WARNING: All workflows and credentials in this project will be affected!

Args:

• id (string): Project ID to delete

Returns: Confirmation of deletion.

Transfer a workflow to a different project.

Args:

• workflowId (string): Workflow ID to transfer

• destinationProjectId (string): Target project ID

Returns: Confirmation of transfer.

List all users in the n8n instance.

Args:

• includeRole (boolean): Include user roles (default: true)

• limit (number): Maximum results (default: 100)

• cursor (string, optional): Pagination cursor

Returns: List of users with id, email, name, and role.

Get details of a specific user.

Args:

• id (string): User ID

Returns: User details with id, email, name, and role.

Get details of the currently authenticated user (owner of the API key).

Returns: Current user details with id, email, name, and role.

Get the current source control (Git) status.

Returns:

• branchName: Current branch

• connected: Whether Git is connected

• ahead: Commits ahead of remote

• behind: Commits behind remote

• conflicts: Any merge conflicts

Pull changes from the remote Git repository.

Args:

• force (boolean): Force pull even with local changes (default: false)

• variables (object, optional): Variables to set after pull

Returns: Pull result with affected files.

Push changes to the remote Git repository.

Args:

• force (boolean): Force push (default: false)

• message (string, optional): Commit message

Returns: Push result with affected files.

Disconnect from the remote Git repository.

⚠️ WARNING: This will remove the Git integration!

Returns: Confirmation of disconnection.

Generate a security audit report for the n8n instance.

Args:

• categories (array, optional): Categories to audit:

  • credentials: Check credential security

  • database: Check database configuration

  • filesystem: Check file system access

  • instance: Check instance configuration

  • nodes: Check node security

• daysAbandonedWorkflow (number, optional): Days to consider workflow abandoned

Returns: Audit report with risk levels and issues by category.

Test the connection to the n8n instance.

Verifies that the API key is valid and the n8n instance is reachable.

Returns:

• connected: Whether connection is successful

• error: Error message if connection failed

Get a list of all available node types in the n8n instance.

Returns: List of node types with their descriptions and categories.

Useful for understanding what nodes are available when creating workflows.

Get a list of all active webhooks in the n8n instance.

Returns: List of active webhooks with their paths and associated workflows.

Export a workflow as JSON for backup or import elsewhere.

Args:

• id (string): Workflow ID to export

Returns: Complete workflow JSON that can be imported into another n8n instance.

Import a workflow from JSON.

Args:

• workflowJson (object): Complete workflow JSON object with:

  • name (string): Workflow name

  • nodes (array): Workflow nodes

  • connections (object): Node connections

  • settings (object, optional): Workflow settings

Returns: The imported workflow with its new ID.

Create a copy of an existing workflow.

Args:

• id (string): Workflow ID to duplicate

• newName (string, optional): Name for the copy (default: "Copy of [original name]")

Returns: The duplicated workflow with its new ID.