> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# n8n

**Authentication:** API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow.

## Sample use cases

* List workflows that errored in the last 24 hours, grouped by trigger type.
* Pause the `Daily Slack Digest` workflow during the migration.
* Find workflows that haven't run in 30 days.

## Available Tools

#### generate\_audit

Generate a security audit report for the n8n instance. Categories: credentials, database, nodes, filesystem, instance.

#### get\_credential\_schema

Get the schema for a credential type to understand required fields. Use before creating credentials.

#### create\_credential

Create a new n8n credential. Use get\_credential\_schema first to understand required fields.

#### delete\_credential

Delete an n8n credential by ID. Only credential owner can delete.

#### transfer\_credential

Transfer an n8n credential to another project. Use list\_projects to find valid project IDs.

#### list\_executions

List n8n workflow executions with optional filters for status, workflow, and project. Use includeData=true for full execution data.

#### get\_execution

Get a specific n8n execution by ID. Use includeData=true to include full execution data.

#### delete\_execution

Delete an n8n execution by ID. Returns success status.

#### retry\_execution

Retry a failed n8n execution. Use loadWorkflow=true to use latest workflow version instead of original.

#### list\_projects

List n8n projects. Returns paginated results.

#### create\_project

Create a new n8n project for organizing workflows and credentials.

#### update\_project

Update an n8n project name.

#### delete\_project

Delete an n8n project by ID.

#### list\_tags

List all n8n tags. Returns paginated results for organizing workflows.

#### get\_tag

Get a specific n8n tag by ID.

#### create\_tag

Create a new n8n tag for organizing workflows.

#### update\_tag

Update an existing n8n tag name.

#### delete\_tag

Delete an n8n tag by ID. Returns success status.

#### list\_users

List n8n users. Only available to instance owner. Returns paginated results.

#### get\_user

Get an n8n user by ID or email. Only available to instance owner.

#### create\_user

Create a new n8n user. Only available to instance owner.

#### delete\_user

Delete an n8n user by ID. Only available to instance owner.

#### change\_user\_role

Change an n8n user's global role. Only available to instance owner.

#### list\_variables

List n8n environment variables. Requires Pro or Enterprise plan. Returns paginated results.

#### create\_variable

Create a new n8n environment variable. Requires Pro or Enterprise plan. Use list\_variables to get the created variable's ID.

#### update\_variable

Update an n8n environment variable. Requires Pro or Enterprise plan.

#### delete\_variable

Delete an n8n environment variable by ID. Requires Pro or Enterprise plan.

#### list\_workflows

List n8n workflows with optional filters for active status, tags, name, and project. Returns paginated results with cursor for next page.

#### get\_workflow

Get a specific n8n workflow by ID. Returns full workflow definition including nodes, connections, and settings.

#### create\_workflow

Create a new n8n workflow with nodes and connections. Returns the created workflow with assigned ID.

#### update\_workflow

Update an existing n8n workflow. Fetches current workflow and merges changes. Returns updated workflow.

#### delete\_workflow

Delete an n8n workflow by ID. Returns success status.

#### activate\_workflow

Activate an n8n workflow to enable trigger-based execution. Returns updated workflow.

#### deactivate\_workflow

Deactivate an n8n workflow to stop trigger-based execution. Returns updated workflow.