MCP - Kondo Docs

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.

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:

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.

Available tools

Inbox & chats

Tool	Description
`list_inboxes`	List inboxes, labels, and filters
`list_inbox`	List chats in an inbox with filters (unread, date range, awaiting reply)
`list_chats`	Search chats by person name or message text
`read_chat`	Read message history for one or more chats
`load_chat`	Fetch full message history from LinkedIn (use when messages are incomplete)

Actions

Tool	Description
`set_chat_draft`	Save a draft reply (does not send — you review and send manually)
`set_chat_label`	Add, remove, or replace labels on chats
`set_chat_archived`	Archive or restore chats
`set_chat_reminder`	Snooze chats until a future time

Connections

Tool	Description
`list_connections`	Search connections by name, company, title, or school
`read_connection`	Read the CRM-style note on a connection
`set_connection_note`	Set or append to a connection’s note
`set_connection_label`	Add, remove, or replace labels on connections

Invites & snippets

Tool	Description
`list_invites`	List pending connection invites
`set_invite_response`	Accept or ignore invites
`list_snippets`	List saved reply templates
`read_snippet`	Read a snippet’s full content
`set_snippet`	Create or update a snippet with smart placeholders
`set_label`	Create 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.

​Requirements

​Setup

​Claude Code

​Claude (web)

​Claude macOS / Windows App

​ChatGPT

​Cursor

​VS Code (GitHub Copilot)

​Other tools

​Examples

​Troubleshooting

​Available tools

​Support

​Disconnecting

Requirements

Setup

Claude Code

Claude (web)

Claude macOS / Windows App

ChatGPT

Cursor

VS Code (GitHub Copilot)

Other tools

Examples

Troubleshooting

Available tools

Support

Disconnecting