For the complete documentation index, see llms.txt. This page is also available as Markdown.

N8N mcp

N8N MCP lets your AI agent use the tools that your n8n instance publishes. You add the MCP server URL and an Authorization header once in Third party apps.


Prerequisites

  • A BotPenguin account with access to the More menu.

  • An n8n instance with MCP turned on.

  • Your n8n MCP URL and authentication header from your n8n instance.


Key Definitions

Term
Meaning

MCP

Model Context Protocol. A standard way for an AI agent to use the tools of another app.

MCP server URL

The address of the MCP server.

Tool

An action that the app publishes. The app decides which tools exist.

Connection

One saved account that your agents can use.


Steps

  1. Click More in the left menu, then click Third party apps.

Click More, then Third party apps
  1. Type n8n MCP in the search box, then open the n8n MCP card.

  1. On the Connected accounts tab, click Add connection.

  2. In the configuration panel, type a Connection name.

  3. Enter the MCP server URL. This field is required. Copy it from your n8n instance.

  4. Under headers, enter the Header name Authorization and the Value from n8n. Both are required. Click Add header to add another pair.

  1. Click Save Configuration. BotPenguin tests the connection and saves it only if the server answers.

  2. Check the Connected accounts tab. Your n8n MCP configuration appears in the list with an Active status.


Common Errors

I do not see Third party apps in the More menu

Click More in the left menu and look under Connections for Third party apps. If it is still missing, your role may not allow it. Ask your account owner.

Save Configuration is grey

Fill in every required field. The URL must start with https://.

BotPenguin says authentication is required

The token or header is missing or wrong. Copy the key again from n8n and save again.

BotPenguin says the server could not be found

The URL is wrong or the server is down. Check the URL in n8n and save again.

My agent says the credentials were rejected

The key was regenerated or deleted in n8n. Add the connection again with the new key.

The tools in my agent changed

n8n publishes the tools, not BotPenguin. Sync the tools again in your agent and select the ones you need.

Can I connect more than one n8n MCP account?

Yes. Click Add connection again. Give each one a clear name so you can pick the right one when you build an agent.


Support

Still not working? Write to us at support@botpenguin.com. We will reach out to you within 24 hours.

Last updated