Set up your client

The fastest path is app.komo.ai/connect — it creates a key and renders every snippet below with your real key filled in.

All clients need two things: the server URL https://mcp.komo.ai/mcp and an API key from app.komo.ai/settings/api-keys. Replace YOUR_API_KEY below with the full pk_…:sk_… pair.

Claude (claude.ai & Desktop)
Claude Code
Cursor
Codex
Other clients

Claude’s connector UI can’t set custom headers, so the key goes in the URL path:

Open Settings → Connectors → Add custom connector
Name: Komo
URL: https://mcp.komo.ai/mcp/YOUR_API_KEY
Click Add — no restart needed

Ask “What can Komo do?” to confirm the connection.

claude mcp add --transport http komo https://mcp.komo.ai/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Verify with /mcp inside a session.

Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "komo": {
      "url": "https://mcp.komo.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Add to ~/.codex/config.toml:

[mcp_servers.komo]
url = "https://mcp.komo.ai/mcp"
http_headers = { "Authorization" = "Bearer YOUR_API_KEY" }

Any client that supports remote MCP servers over Streamable HTTP works:

URL: https://mcp.komo.ai/mcp
Auth: Authorization: Bearer YOUR_API_KEY or x-api-key: YOUR_API_KEY
Header-less clients: https://mcp.komo.ai/mcp/YOUR_API_KEY

Optional: the Komo prospecting skill

For noticeably better results in Claude, add the komo-prospecting skill — a workflow guide that teaches Claude Komo etiquette (qualify the ICP before spending credits, always save results to lists, never send without showing you the message first). Download the zip from app.komo.ai/connect and upload it at claude.ai → Settings → Capabilities → Skills (or drop the folder into ~/.claude/skills/ for Claude Code). The MCP server works fine without it.

Connecting LinkedIn and email from chat

Sending tools need a connected LinkedIn seat or email inbox. You can start either connection from chat — the tool returns a secure browser URL:

Ask: “Connect my LinkedIn account.”
The assistant calls connect_linkedin_account and gives you a hosted sign-in link — your credentials go to LinkedIn’s flow, never through the chat.
Finish in the browser, then ask the assistant to verify with list_linkedin_accounts.

Email works the same way via connect_email_account (Gmail / Outlook OAuth).

Troubleshooting

Symptom	Fix
”API key invalid or revoked”	Create a new key at settings/api-keys and update your client config.
”Payment required” on a tool	Your credit balance can’t cover the action — top up at settings/billing.
”Rate/safety limit hit” on LinkedIn sends	The seat’s daily/weekly cap or pacing window is active; the message includes when to retry. Limits are adjustable per seat at settings/linkedin.
Client can’t connect at all	Confirm the URL is exactly `https://mcp.komo.ai/mcp` and your client supports Streamable HTTP (SSE-only clients are not supported).

​Optional: the Komo prospecting skill

​Connecting LinkedIn and email from chat

​Troubleshooting

Optional: the Komo prospecting skill

Connecting LinkedIn and email from chat

Troubleshooting