Requirements MCP is available on the Business tier and requires the Kondo browser extension.
Kondo browser extension must be installed and running — MCP only works while a Kondo tab is open in your browser. Install the extension .OAuth sign-in — You’ll authenticate with your Kondo account the first time you connect.Data privacy — Message data is accessed via your browser session. Command and response data passes through Kondo’s relay in memory and is not stored. Privacy Policy .
Setup Claude Code Run this command in your terminal:
claude mcp add kondo --transport http https://relay.trykondo.com/mcp
Then authenticate by running /mcp in Claude Code and following the sign-in flow.
Claude (web)
Go to claude.ai/settings/integrations
Click Add more integrations , then Add custom MCP server
Enter a name (e.g. “Kondo”) and paste the URL:
https://relay.trykondo.com/mcp
Click Add and complete the sign-in flow
Start a new chat and Kondo’s tools will appear in the tools menu.
Claude macOS / Windows App
Open Settings > Connectors or Customize > Connectors
Click Add Connector and enter the URL:
https://relay.trykondo.com/mcp
Complete the sign-in flow to connect your Kondo account
ChatGPT Requires a ChatGPT Business, Enterprise, or Edu plan. Plus/Pro users can connect via Developer Mode but cannot publish apps to a workspace. A workspace Admin or Owner must first enable Developer Mode in Settings > Apps > Advanced settings > Developer mode .
In ChatGPT, go to Settings > Apps > Create
Enter the name Kondo and paste the URL:
https://relay.trykondo.com/mcp
Click Create and complete the OAuth flow to connect your Kondo account
ChatGPT will show a confirmation prompt before any write action (archive, label, draft, etc.).
Publishing to your workspace
Only Admins and Owners can publish apps for the whole workspace.
Go to Workspace Settings > Apps
Click Drafts , find Kondo, then click Publish
Review any safety warnings (Kondo supports write actions like archiving and labeling)
Once published, all workspace members will see Kondo in their Apps settings
On Business plans, apps cannot be updated after publishing — you must recreate and republish. Enterprise/Edu plans support updates and RBAC controls. Cursor
Open Cursor Settings > MCP > Add new global MCP server
Paste the following configuration:
{ "mcpServers" : { "kondo" : { "url" : "https://relay.trykondo.com/mcp" } } }
Save and restart Cursor. Complete the sign-in flow when prompted.
VS Code (GitHub Copilot) Create a .vscode/mcp.json file in your workspace:
{ "servers" : { "kondo" : { "type" : "http" , "url" : "https://relay.trykondo.com/mcp" } } }
Open the Command Palette (Cmd+Shift+P or Ctrl+Shift+P) and run MCP: List Servers to start the server. Complete the sign-in flow when prompted.
Kondo’s MCP server uses the Streamable HTTP transport. Any MCP client that supports this transport can connect.
Most MCP clients accept a JSON configuration:
{ "mcpServers" : { "kondo" : { "url" : "https://relay.trykondo.com/mcp" } } }
Some clients use httpUrl instead of url for Streamable HTTP (e.g. Gemini CLI ):
{ "mcpServers" : { "kondo" : { "httpUrl" : "https://relay.trykondo.com/mcp" } } }
If your client only supports local stdio servers, use mcp-remote as a bridge:
{ "mcpServers" : { "kondo" : { "command" : "npx" , "args" : [ "-y" , "mcp-remote" , "https://relay.trykondo.com/mcp" ] } } }
Examples Here’s what you can do once connected:
Prompt What happens ”Show me my unread messages” Returns a prioritized summary of your unread messages. ”Draft a follow-up for every chat labeled Lead where I sent the last message more than 3 days ago.” Finds matching chats and saves a draft reply to each. You review and send manually. ”Label all recruiter messages as Recruiter” Identifies recruiter chats and applies the label. ”Find my connections at Acme Corp” Searches your LinkedIn connections by company and lists matching people. ”Go through my chats from the last 3 days and set reminders for anything I need to follow up on.” Scans recent chats and identifies follow-ups.
Troubleshooting Problem Fix No tools appear Make sure a Kondo tab is open and the browser extension is active. Sign-in fails Revoke access in Settings > MCP , then reconnect. Commands stop working Refresh the Kondo tab and try again. The extension must stay running.
Inbox & chats Tool Description list_inboxesList inboxes, labels, and filters list_inboxList chats in an inbox with filters (unread, date range, awaiting reply) list_chatsSearch chats by person name or message text read_chatRead message history for one or more chats load_chatFetch full message history from LinkedIn (use when messages are incomplete)
Actions Tool Description set_chat_draftSave a draft reply (does not send — you review and send manually) set_chat_labelAdd, remove, or replace labels on chats set_chat_archivedArchive or restore chats set_chat_reminderSnooze chats until a future time
Connections Tool Description list_connectionsSearch connections by name, company, title, or school read_connectionRead the CRM-style note on a connection set_connection_noteSet or append to a connection’s note set_connection_labelAdd, remove, or replace labels on connections
Invites & snippets Tool Description list_invitesList pending connection invites set_invite_responseAccept or ignore invites list_snippetsList saved reply templates read_snippetRead a snippet’s full content set_snippetCreate or update a snippet with smart placeholders set_labelCreate or rename a label
Support Questions or issues? Contact us .
Disconnecting To disconnect an MCP client, go to Settings > MCP and click Revoke next to the application you want to remove. This immediately revokes access for that client. 