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

# MCP

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

## Requirements

<Info>
  MCP is available on the **Business tier** and requires the Kondo browser extension.
</Info>

* **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.
</Note>

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 title="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.
</Accordion>

### 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 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](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                                 |
| `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](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.