Kenso MCP tools

Mail Messages mail_messages

The caller's own Gmail or Outlook mail, read live: search it and read one message. Never Kenso's campaign replies (those are threads).

Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through mail_messages_read. Each takes operation plus that operation's parameters, and your workspace role decides which operations you see.

Each operation with a route calls the Kenso API at https://api.ken.so with Authorization: Bearer <Kenso API key>, Ken-Version: 1.1 and X-Ken-Workspace-Id: <workspace id>. You can call that route directly with the same headers.

Operations: get, search

get

Read. Early access: needs connected_app_reads on for the workspace. GET https://api.ken.so/v1/mail/messages/{messageId}

Path: messageId

Read one message of your own mailbox, with its body as plain text.

GET /api/v1/mail/messages/{messageId}. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
Read only. message_id is a mail_ id from operation search.

Returns data (id, provider, from, to[], cc[], subject, snippet, receivedAt, body,
isBodyTruncated). body is plain text, HTML-only mail converted, at most 20,000
characters; isBodyTruncated is true when it was cut. 404 when the message is not in
the caller's own connected mailbox (or the mailbox was reconnected since the search:
search again); 409 mailbox_not_connected; 503 provider_unavailable.

Read. Early access: needs connected_app_reads on for the workspace. GET https://api.ken.so/v1/mail/messages

Query: limit integer, q string

Search your own connected Gmail or Outlook mail; with no q, list your newest messages.

GET /api/v1/mail/messages. Sends Ken-Version 1.1 and X-Ken-Actor: agent. Read only.

Searches the caller's own mailbox only, through the Google or Outlook account they
connected in Kenso with email access (Gmail first when both are connected). q is the
provider's own search syntax, at most 200 characters: plain words work on both, and
Gmail also takes operators such as from:, subject: and newer_than:7d. limit is 1 to
25 (default 10). Newest first; drafts and chats are left out.

Returns data[] (id, provider gmail|outlook, from, to[], cc[], subject, snippet,
receivedAt) and pagination.hasMore. There is no cursor: narrow q to see more. Read a
message's body with operation get and its id. 409 mailbox_not_connected when the
caller has no connected mailbox with email access; 400 when the provider refuses the
search text; 503 provider_unavailable when Google or Microsoft fails.