Kenso

MCP clients

Connect Kenso to n8n with MCP

n8n connects to Kenso's remote MCP server with its MCP Client Tool node. Add the node to an AI Agent, set Endpoint to Kenso's server URL and Server Transport to HTTP Streamable, then use Bearer Auth with a Kenso API key.

How Do You Connect Kenso to n8n?

In short Add https://mcp.ken.so/mcp as a remote MCP server in n8n with your Kenso API key as a Bearer header.

  1. Create a Kenso API Key

    In the Kenso app, open Settings > Integrations > API Keys and create a key for this workflow.

  2. Add the MCP Client Tool

    Open a workflow with an AI Agent node, select the plus under Tool and add MCP Client Tool.

  3. Point It at Kenso

    Set Endpoint to the server URL below and Server Transport to HTTP Streamable. If your key reaches several Kenso workspaces, add ?workspace= and the workspace id to the URL.

    https://mcp.ken.so/mcp
  4. Add Your Key

    Set Authentication to Bearer Auth, create a credential and paste your Kenso API key as the token. Leave Tools to Include on All, or pick the Kenso tools the agent may use.

What Can You Ask Kenso From n8n?

In short Ask in plain language. The client picks the Kenso tool, and Kenso runs it with your workspace role.

Example requests in n8n and the Kenso MCP tool that answers each one
AskKenso tool usedWhat the tool does
Find VPs of Sales at US software companies with 50 to 200 employees.search_readSearches Kenso's people and company database and returns filter facets.
Which of my campaigns are running right now?campaigns_readLists campaigns and reads one campaign's settings and status.
How did my campaigns do this week? Show sends, replies and bounces for each one.analytics_readReads campaign performance, engagement, deliverability and reply classifications.
Show me the replies that came in today and summarize each one.threads_readLists inbox threads and reads their messages.
Before I launch, preview who lands in the Series B segment.segments_readPreviews which contacts land in a campaign segment.
How many emails a day can this campaign send with the inboxes it has?campaign_flow_readEstimates how many emails a campaign can send with its inboxes.

Admins and members get read and write tools. A view-only seat gets read tools plus 8 write tools, inbox replies among them. Only the read-only URL, https://mcp.ken.so/mcp/readonly, removes every tool that writes.

What If Kenso Does Not Connect in n8n?

In short Most failures come from a skipped sign-in step or a client setting.

Common n8n connection problems and fixes
ProblemFix
A Kenso tool says the connection is not pinned to a workspaceYour API key reaches several Kenso workspaces. Add ?workspace= and the workspace id to the Endpoint, for example https://mcp.ken.so/mcp?workspace=42.
The node shows SSE Endpoint instead of EndpointThat is the node's first version, which only speaks SSE. Add MCP Client Tool again to get the current version, then set Server Transport to HTTP Streamable.
Kenso answers 401 with an API keyThe key was revoked or mistyped. Create a new one in the Kenso app under Settings > Integrations > API Keys.

Frequently Asked Questions

Can n8n sign in to Kenso with OAuth instead of an API key?

The node offers an MCP OAuth2 credential, but a workflow that runs on its own is simpler with an API key. Create one key per workflow, so you can revoke it without touching anything else.

Which Kenso workspace does an n8n workflow use?

The one your API key works in. A key that reaches several workspaces must name one: add ?workspace= and the workspace id to the Endpoint. The id is the number after app.ken.so/ in the app's address.

What can n8n change in my Kenso workspace?

Only what your Kenso role allows. Admins and members get read and write tools, including campaign launches. A view-only seat gets read tools plus 8 write tools: email_copy_write, permissions_write, replies_write, saved_searches_write, scheduler_write, search_write, tags_write and threads_write. Of those, threads_write can send a reply email, delete threads and bulk-update them, and scheduler_write can bulk-cancel bookings. For a connection that cannot change anything, use https://mcp.ken.so/mcp/readonly. Kenso checks your role on every call, so a role change applies right away.

Free credits: 1,000 credits ($20) once, no card.

Sources

Every source, with the date we checked it
SourceChecked
n8n docs: MCP Client Tool node
n8n source: MCP Client Tool node versions and fields

Changelog

  1. Page published.