MCP

Requirements

MCP is available on the Business tier.

Kondo desktop app must be open — MCP only works while the Kondo app is running on your computer. Install Kondo.
OAuth sign-in — You'll authenticate with your Kondo account the first time you connect.
Data privacy — Message data is read from the Kondo app on your computer. 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://mcp.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://mcp.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://mcp.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://mcp.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://mcp.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://mcp.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://mcp.trykondo.com/mcp"
    }
  }
}

Some clients use httpUrl instead of url for Streamable HTTP (e.g. Gemini CLI):

{
  "mcpServers": {
    "kondo": {
      "httpUrl": "https://mcp.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://mcp.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.
"Which chats labeled Lead are waiting on my reply?"	Lists chats with that label where the other person sent the last message.
"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 the Kondo app is open.
Tools answer from another computer	Kondo answers from one device at a time. Open Settings > MCP on this computer and click Switch here.
Sign-in fails	Revoke the app in Settings > Account under Connected apps, then reconnect.
Commands stop working	Quit and reopen Kondo, then try again. The app must stay open.

Available tools

These are the tools of the Kondo desktop app's MCP server. Kondo for LinkedIn has a separate MCP server with different tools, see MCP for Kondo for LinkedIn.

Accounts & inboxes

Tool	Description
`list_pairings`	List your connected messaging accounts and whether each is online
`list_inboxes`	List inboxes, labels, and label filters
`list_inbox`	Browse the chats in an inbox, with filters (unread, date range, awaiting reply, needs my reply)
`list_chats`	Search chats by person name or message text
`read_chat`	Read the messages of one or more chats, including voice message transcripts
`navigate`	Open a chat, inbox, people, snippets, or a settings page in Kondo and bring the app to the front

Chat actions

Tool	Description
`set_chat_draft`	Save a draft reply, or a first message to someone you haven't messaged yet (does not send, you review and send it)
`set_chat_label`	Add, remove, or replace labels on chats
`set_chat_archived`	Archive or restore chats
`set_chat_reminder`	Set or clear a reminder (archives the chat until the reminder is due)

People

Tool	Description
`list_contacts`	List or search people by name, phone, email, or username, including address book contacts you haven't messaged
`read_contact`	Read a person's details, labels, chats, and note
`set_contact_label`	Add, remove, or replace labels on people
`set_contact_note`	Set or append to the note kept about a person

Labels, inboxes & snippets

Tool	Description
`set_label`	Create a label, or rename or recolor one
`set_inbox`	Create, update, or delete an inbox that combines labels
`list_snippets`	List saved reply templates
`read_snippet`	Read a snippet's full content
`set_snippet`	Create or update a snippet with smart placeholders

Preferences

Tool	Description
`read_preferences`	Read your app preferences, including notifications and quiet hours
`set_preferences`	Change app preferences

Support

Questions or issues? Contact us.

Disconnecting

To disconnect an MCP client, go to Settings > Account, find the app under Connected apps and click Revoke. This immediately revokes access for that client.