N 8 N MCP server

Connect N 8 N to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the N 8 N MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the get execution tool in N 8 N
  • Use the manage workflow tags tool in N 8 N
  • Use the get workflow tool in N 8 N
  • Use the update workflow tool in N 8 N
  • Use the list executions tool in N 8 N
  • Use the list credentials tool in N 8 N

Supported Tools

get_execution

Get Execution

Retrieve details of a specific workflow execution including its status, timing, and optionally the full execution data with node-level results.

manage_workflow_tags

Manage Workflow Tags

Get or update the tags assigned to a workflow. Use this to organize workflows by setting their tags, or to inspect current tag assignments.

get_workflow

Get Workflow

Retrieve a current workflow definition or an exact historical version. Optionally provide a downloadable JSON copy. Historical snapshots do not assert current publication status.

update_workflow

Update Workflow

Update an existing workflow's definition, including its name, nodes, connections, and settings. Omitted definition fields are hydrated from a fresh read. Updating a published workflow may re-publish it unless publishIfActive is false. Failures can still leave a saved draft; the read/replace sequence is not atomic.

list_executions

List Executions

List workflow executions with optional filtering by workflow, status, and project. Returns execution metadata including status, start/end times, and workflow info.

list_credentials

List Credentials

List all credentials stored in your n8n instance. Returns metadata only (name, type, timestamps) without exposing sensitive credential data.

delete_execution

Delete Execution

Permanently delete a workflow execution record. This action cannot be undone.

activate_workflow

Activate Workflow

Activate (publish) or deactivate a workflow. Activating makes the workflow live and able to receive trigger events. Optionally activate a specific historical version by providing a version ID.

stop_execution

Stop Execution

Stop a currently running workflow execution.

retry_execution

Retry Execution

Retry a failed workflow execution. By default, retries using the original workflow version from the failed execution. Set **useCurrentWorkflow** to true to retry with the latest workflow definition instead.

delete_workflow

Delete Workflow

Permanently delete a workflow from n8n. This action cannot be undone.

list_workflows

List Workflows

List workflows in your n8n instance with optional filtering. Returns workflow metadata including name, active status, creation date, and tags. Supports filtering by active status, tags, name, and project.

create_workflow

Create Workflow

Create a new workflow in n8n. Provide the workflow name, nodes, connections, and optional settings. The workflow is created in an inactive state by default.

source_control_pull

Source Control Pull

Pull workflow changes from a connected Git repository into your n8n instance. Requires the Source Control feature to be licensed and configured.

manage_projects

Manage Projects

Create, update, delete, or list projects in n8n. Projects group workflows and credentials for access control. Also supports managing project members.

manage_tags

Manage Tags

Create, update, delete, or list tags used to organize workflows and credentials. Specify an **action** to determine the operation.

list_users

List Users

List users on the n8n instance. Requires the applicable API-key scopes and instance/project permissions.

transfer_resource

Transfer Resource

Transfer a workflow or credential to a different project. Useful for reorganizing resources across projects.

delete_credential

Delete Credential

Permanently delete a credential from n8n. Workflows using this credential will no longer be able to authenticate. This action cannot be undone.

get_credential_schema

Get Credential Schema

Retrieve the JSON schema for a specific credential type. This is useful for understanding the required fields and their types before creating a credential.

manage_variables

Manage Variables

Create, update, delete, or list variables stored in your n8n instance. Variables provide fixed data accessible across all workflows. Requires Pro or Enterprise plan.

generate_audit

Generate Security Audit

Generate a security audit report for your n8n instance. The report covers risk categories including credentials, database, nodes, filesystem, and instance-level risks. Optionally configure which categories to include and the threshold for abandoned workflows.

create_credential

Create Credential

Create a new credential in n8n. Use the **Get Credential Schema** tool first to understand the required fields for a given credential type.

discover_api

Discover API

Read the native capability map filtered by this API key’s scopes, optionally including request schemas. This is not user identity, a server-version claim or proof that a licensed feature is enabled. Older deployments may not expose this route.

Connect N 8 N to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable N 8 N in Metorial. In your Metorial portal, enable the N 8 N MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load N 8 N tools.

Run N 8 N through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give N 8 N and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use N 8 N tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with N 8 N

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

Google Sheets

Create, read, and update spreadsheets and their cell data. Read and write values to individual cells, ranges, or multiple ranges using A1 notation or named ranges. Apply cell formatting including text styles, backgrounds, borders, number formats, and conditional formatting. Manage sheets (tabs) within a spreadsheet—add, delete, copy, rename, and reorder them. Create and manage embedded charts, pivot tables, filter views, data validation rules, protected ranges, named ranges, and merged cells. Perform batch operations to apply multiple updates atomically.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Technical notes for N 8 N

Manage workflows, executions, credentials, users, and projects on an n8n workflow automation instance. Create, update, activate, deactivate, and delete workflows programmatically. List and retrieve execution history, retry failed executions, and filter by status or date range. Create and manage credentials for external service authentication, including retrieving credential schemas. Organize resources with tags and variables. Manage projects for access control. Pull and push workflow changes via source control integration with Git. Generate security audit reports for the instance.

Frequently asked questions

Common questions about connecting N 8 N to AI agents with Metorial.

  1. How many tools does the N 8 N MCP server have?
    The N 8 N MCP server exposes 24 tools, including Get Execution, Manage Workflow Tags, Get Workflow. Each one is governed and traced through Metorial.
  2. N 8 N exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the N 8 N MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use N 8 N and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the N 8 N MCP server yourself or use the hosted gateway.

Connect N 8 N to production AI agents

See how Metorial gives your team governed access to N 8 N, with tracing and security controls built in.