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.
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.
search
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.