ZenMode MCP server

ZenMode is LinkedIn outreach software. Its remote MCP server lets an AI assistant work with your ZenMode account in plain language: read campaigns, contacts and conversations, add or remove people in a campaign, pause or exclude a contact, and change who a campaign finds.

It works with Claude, ChatGPT and other MCP clients.

• Server address: https://www.zen-mode.io/api/mcp
• Transport: Streamable HTTP
• Sign-in: approve the connection in your client (OAuth), or use a ZenMode API key as a Bearer token
• Plan: Practitioner and above. The MCP server and the REST API are not on Novice.
• Contact: hello@zen-mode.io
• Official MCP Registry: io.zen-mode/zenmode

This repository holds documentation only. The server runs at the address above and its source is not published here.

What it can do

Twenty-two tools. Everything is scoped to the ZenMode account you sign in with.

Read

Change (each is marked as a change, so a client can ask you to confirm it)

Campaigns (paid plans)

What it cannot do

There is no tool that sends a LinkedIn message or a connection request. A campaign starts only through launch_campaign's two calls, after you confirm. Adding people to a campaign puts them in that campaign's worklist. ZenMode's desktop app then works through the list later, inside the account's daily and weekly limits and business hours, and only while the desktop app is running.

If the account is restricted, paused for the week, cooling down or switched off, a change that would widen who can be contacted is refused with the reason and when it lifts.

Set up

Claude (claude.ai)

1. Open Customize → Connectors, click +, then Add custom connector. On a Team or Enterprise plan an owner adds it under Organization settings → Connectors → Add → Custom → Web.
2. Name it ZenMode and paste https://www.zen-mode.io/api/mcp. Leave the advanced OAuth settings empty.
3. Click Connect. Sign in to ZenMode if asked, choose Read only (the default) or Read and change, pick the API key to connect with, and click Allow.
4. In a new chat, open the + menu, go to Connectors, and switch ZenMode on.

Claude Code

claude mcp add --transport http zenmode https://www.zen-mode.io/api/mcp --header "Authorization: Bearer YOUR_ZENMODE_API_KEY"

Run claude mcp list to check it connected.

ChatGPT

Add ZenMode as a custom MCP server in ChatGPT, approve it on a ZenMode page, and keep the scopes on read only unless you want ChatGPT to make changes. Step by step, from a real run on a Plus account: https://www.zen-mode.io/integrations/chatgpt. Which ChatGPT plans can add a custom MCP server is up to OpenAI.

Cursor

Add ZenMode to Cursor (one-click install; it reads your key from the ZENMODE_API_KEY environment variable). Or add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "zenmode": {
      "url": "https://www.zen-mode.io/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:ZENMODE_API_KEY}"
      }
    }
  }
}

Set ZENMODE_API_KEY in your environment so the key is not stored in the file.

VS Code (GitHub Copilot)

Add this to your user mcp.json. VS Code asks for the key and keeps it out of the file:

{
  "servers": {
    "zenmode": {
      "type": "http",
      "url": "https://www.zen-mode.io/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:zenmode-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "zenmode-api-key",
      "description": "ZenMode API key",
      "password": true
    }
  ]
}

Gemini CLI

Install the extension from this repository. It adds the server; Gemini CLI then asks you to sign in to ZenMode:

gemini extensions install https://github.com/zenmode87/zenmode-mcp

Or add the server yourself with an API key:

gemini mcp add --scope user --transport http -H "Authorization: Bearer YOUR_ZENMODE_API_KEY" zenmode https://www.zen-mode.io/api/mcp
gemini mcp list

Create an API key in the ZenMode dashboard at https://www.zen-mode.io/dashboard/api. Revoking the key ends the connection.

Grok Build

This repository is also a Grok Build plugin: .grok-plugin/plugin.json and .mcp.json point Grok Build at the same server address. Sign in to ZenMode when it first connects.

Example prompts

• "How are my LinkedIn campaigns doing over the last 30 days?" uses list_campaigns.
• "Find everyone at Acme I've been talking to and show me the latest conversation." uses search_contacts, then get_conversation.
• "Add these five LinkedIn profiles to my Q4 founders campaign and tell me if any were refused." uses add_leads_to_campaign.

Limits

Per ZenMode API key (a connection made through sign-in shares the budget of the key it uses):

• 60 tool calls a minute
• 10 changes a minute and 300 a day
• 500 leads added per day, up to 100 per call

Links

• Setup guides for every client: https://www.zen-mode.io/integrations/mcp
• Guide for Claude: https://www.zen-mode.io/integrations/claude
• Pricing: https://www.zen-mode.io/pricing
• Privacy policy: https://www.zen-mode.io/privacy
• Terms: https://www.zen-mode.io/terms
• Service status: https://www.zen-mode.io/status
• llms.txt: https://www.zen-mode.io/llms.txt

Licence

The documentation in this repository is licensed under Creative Commons Attribution 4.0 International. That licence covers the text of these files only. It does not cover the ZenMode name or logo, and it does not grant any right to the ZenMode software or service.