|
| 1 | +--- |
| 2 | +title: MCP Client node documentation |
| 3 | +description: Learn how to use the MCP Client node in n8n. Follow technical documentation to integrate MCP Client node into your workflows. |
| 4 | +contentType: [integration, reference] |
| 5 | +--- |
| 6 | + |
| 7 | +# MCP Client node |
| 8 | + |
| 9 | +The MCP Client node is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) client that allows you to use the tools that are exposed by an external MCP server. |
| 10 | + |
| 11 | +You can use the MCP Client node to use MCP tools as regular steps in a workflow. |
| 12 | + |
| 13 | +If you want to use MCP tools as tools for an AI Agent, use the [MCP Client Tool node](/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp.md) instead. |
| 14 | + |
| 15 | +/// note | Credentials |
| 16 | +The MCP Client node supports [Bearer](/integrations/builtin/credentials/httprequest.md#using-bearer-auth), generic [header](/integrations/builtin/credentials/httprequest.md#using-header-auth), and [OAuth2](/integrations/builtin/credentials/httprequest.md#using-oauth2) authentication methods. |
| 17 | +/// |
| 18 | + |
| 19 | +## Node parameters |
| 20 | + |
| 21 | +Configure the node with the following parameters. |
| 22 | + |
| 23 | +* **Server Transport**: The transport protocol used by the MCP Server endpoint you want to connect to. |
| 24 | +* **MCP Endpoint URL**: The URL of the external MCP Server. For example, `https://mcp.notion.com/mcp`. |
| 25 | +* **Authentication**: The authentication method for authentication to your MCP server. The MCP Client node supports [bearer](/integrations/builtin/credentials/httprequest.md#using-bearer-auth), generic [header](/integrations/builtin/credentials/httprequest.md#using-header-auth), and [OAuth2](/integrations/builtin/credentials/httprequest.md#using-oauth2) authentication. Select **None** to attempt to connect without authentication. |
| 26 | +* **Tool**: Select the tool to use in the node. The list of tools is automatically fetched from the external MCP server. |
| 27 | +* **Input Mode**: |
| 28 | + * **Manual**: Specify each tool parameter manually. |
| 29 | + * **JSON**: Specify tool parameters as a JSON object. Use this mode for tools with nested parameters. |
| 30 | + |
| 31 | +## Options |
| 32 | + |
| 33 | +* **Convert to Binary**: Whether to convert images and audio to binary data. If false, images and audio are returned as base64 encoded strings. |
| 34 | +* **Timeout**: Time in milliseconds to wait for tool calls to finish. |
| 35 | + |
| 36 | +## Templates and examples |
| 37 | + |
| 38 | +<!-- see https://www.notion.so/n8n/Pull-in-templates-for-the-integrations-pages-37c716837b804d30a33b47475f6e3780 --> |
| 39 | +[[ templatesWidget(page.title, 'mcp-client') ]] |
| 40 | + |
| 41 | +## Related resources |
| 42 | + |
| 43 | +To use MCP tools with AI Agents, n8n has the [MCP Client Tool node](/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp.md). |
| 44 | + |
| 45 | +n8n also has an [MCP Server Trigger](/integrations/builtin/core-nodes/n8n-nodes-langchain.mcptrigger.md) node that allows you to expose n8n tools to external AI Agents. |
| 46 | + |
| 47 | +Refer to the [MCP documentation](https://modelcontextprotocol.io/introduction) and [MCP specification](https://modelcontextprotocol.io/specification/) for more details about the protocol, servers, and clients. |
| 48 | + |
| 49 | +--8<-- "_snippets/integrations/builtin/cluster-nodes/tools-link.md" |
| 50 | + |
| 51 | +--8<-- "_snippets/integrations/builtin/cluster-nodes/langchain-overview-link.md" |
| 52 | + |
0 commit comments