Skip to main content

​
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)

  1. Go to claude.ai/settings/integrations
  2. Click Add more integrations, then Add custom MCP server
  3. Enter a name (e.g. “Kondo”) and paste the URL:
https://relay.trykondo.com/mcp
  1. 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

  1. Open Settings > Connectors or Customize > Connectors
  2. Click Add Connector and enter the URL:
https://relay.trykondo.com/mcp
  1. 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.
  1. In ChatGPT, go to Settings > Apps > Create
  2. Enter the name Kondo and paste the URL:
https://relay.trykondo.com/mcp
  1. 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.).
Only Admins and Owners can publish apps for the whole workspace.
  1. Go to Workspace Settings > Apps
  2. Click Drafts, find Kondo, then click Publish
  3. Review any safety warnings (Kondo supports write actions like archiving and labeling)
  4. 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

  1. Open Cursor Settings > MCP > Add new global MCP server
  2. Paste the following configuration: 
{
  "mcpServers": {
    "kondo": {
      "url": "https://relay.trykondo.com/mcp"
    }
  }
}
  1. 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.

​
Other tools

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:
PromptWhat 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

ProblemFix
No tools appearMake sure a Kondo tab is open and the browser extension is active.
Sign-in failsRevoke access in Settings > MCP, then reconnect.
Commands stop workingRefresh the Kondo tab and try again. The extension must stay running.

​
Available tools

Inbox & chats
ToolDescription
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
ToolDescription
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
ToolDescription
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
ToolDescription
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.