How do I install ZenMode?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does ZenMode need an API key?

No required environment variable is listed on this record.

When was ZenMode last checked?

Last checked 2026-11-10. Read LinkedIn outreach campaigns, contacts and replies, and manage campaign leads and targeting.

ZenMode MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://www.zen-mode.io/api/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http io.zen-mode-zenmode https://www.zen-mode.io/api/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.zen-mode-zenmode": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://www.zen-mode.io/api/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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: [email protected]
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

tool	what it returns
`get_account_summary`	plan, whether the ZenMode desktop app has checked in recently, campaigns by status, and the last 30 days of results
`list_campaigns`	your campaigns with status, daily limit and results for a date window
`get_campaign`	one campaign: type, status, daily limit, business hours, targeting, contacts per stage, results
`search_contacts`	contacts across your campaigns by name, company, job title or LinkedIn URL
`get_contact`	one contact: profile details, campaign, status, outreach state, do-not-contact status
`get_conversation`	the LinkedIn conversation history with one contact, oldest first
`get_campaign_targeting`	who a campaign is set to find
`get_safety_status`	what ZenMode's own limits say about the account right now
`get_setup_status`	where the account is in setup, and the next step
`get_desktop_app`	the desktop app download and install command
`start_trial`	a checkout link for the free 14-day trial (accounts with no plan only)

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

tool	what it does
`add_leads_to_campaign`	add up to 100 people to a campaign by LinkedIn profile URL; invalid URLs, your do-not-contact list, the campaign's exclusion list and duplicates are refused and reported per person
`remove_leads_from_campaign`	remove up to 100 contacts from a campaign
`set_contact_outreach_state`	pause a contact, put them on your do-not-contact list, or mark them not interested
`update_campaign_targeting`	change job titles, locations, industries and companies a campaign finds

Campaigns (paid plans)

tool	what it does
`validate_message`	check a connection note or follow-up against ZenMode's message rules before it is saved; changes nothing
`create_campaign`	create a connect campaign with a name, targeting and daily limit; always created paused
`set_campaign_messages`	write a campaign's connection note and up to three follow-ups; the server checks each one again
`launch_campaign`	start a paused campaign in two calls: a preflight that changes nothing and returns a summary and a confirm token, then the same tool with that token after you say yes
`resume_campaign`	the same preflight for a paused campaign; it starts nothing
`pause_campaign`	pause a running campaign
`set_up_desktop_app`	what state the desktop app is in for your account and how to open, update or install it; changes nothing

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)

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.
Name it ZenMode and paste https://www.zen-mode.io/api/mcp. Leave the advanced OAuth settings empty.
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.
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

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.

ZenMode

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install ZenMode?

Does ZenMode need an API key?

What transport does ZenMode use?

When was ZenMode last checked?

Documentation

ZenMode MCP server

What it can do

What it cannot do

Set up

Claude (claude.ai)

Claude Code

ChatGPT

Cursor

VS Code (GitHub Copilot)

Gemini CLI

Grok Build

Example prompts

Limits

Links

Licence