> ## Documentation Index
> Fetch the complete documentation index at: https://kondo.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> Control your Kondo inbox from Claude, Cursor, ChatGPT, and other MCP tools.

## Requirements

> [!NOTE]
>
> 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](https://app.trykondo.com).
* **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](https://www.trykondo.com/privacy).

## Setup

### Claude Code

Run this command in your terminal:

```bash theme={null}
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](https://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
```

4. 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
```

3. Complete the sign-in flow to connect your Kondo account

### ChatGPT

> [!NOTE]
>
> Requires a ChatGPT Business, Enterprise, or Edu plan. Plus/Pro users can connect via [Developer Mode](https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-connectors-in-chatgpt-beta) but cannot publish apps to a workspace.

A workspace Admin or Owner must first enable Developer Mode in **Settings > Apps > Advanced settings > [Developer mode](https://developers.openai.com/api/docs/guides/developer-mode)**.

1. In ChatGPT, go to **Settings > Apps > Create**
2. Enter the name `Kondo` and paste the URL:

```
https://relay.trykondo.com/mcp
```

3. 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.).

> [accordion] Publishing to your workspace
>
> 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:

```json theme={null}
{
  "mcpServers": {
    "kondo": {
      "url": "https://relay.trykondo.com/mcp"
    }
  }
}
```

3. Save and restart Cursor. Complete the sign-in flow when prompted.

### VS Code (GitHub Copilot)

Create a `.vscode/mcp.json` file in your workspace:

```json theme={null}
{
  "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:

```json theme={null}
{
  "mcpServers": {
    "kondo": {
      "url": "https://relay.trykondo.com/mcp"
    }
  }
}
```

Some clients use `httpUrl` instead of `url` for Streamable HTTP (e.g. [Gemini CLI](https://geminicli.com/docs/tools/mcp-server/)):

```json theme={null}
{
  "mcpServers": {
    "kondo": {
      "httpUrl": "https://relay.trykondo.com/mcp"
    }
  }
}
```

If your client only supports local stdio servers, use [mcp-remote](https://www.npmjs.com/package/mcp-remote) as a bridge:

```json theme={null}
{
  "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 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](https://app.trykondo.com/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 (searches what Kondo has stored; can fall back to searching LinkedIn directly) |
| `read_chat` | Read message history for one or more chats |
| `load_chat` | Fetch the full message history of a chat from LinkedIn into Kondo (slow; use only when messages are incomplete, then call `read_chat` to read them) |

**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 (archives them until the reminder is due) |

**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](https://www.trykondo.com/contact).

## Disconnecting

To disconnect an MCP client, go to [Settings > MCP](https://app.trykondo.com/settings/mcp) and click **Revoke** next to the application you want to remove. This immediately revokes access for that client.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.