MCP servers

Kondo's LinkedIn MCP server for Claude Code, Codex & other AI agents

Kondo's LinkedIn MCP server lets Claude Code, Codex, ChatGPT and other AI agents read your LinkedIn DMs, draft replies and sort chats into folders.

What is Kondo's LinkedIn MCP server?

It's a hosted MCP (Model Context Protocol) server that gives AI agents access to the LinkedIn inbox you manage in Kondo. Any agent that supports remote MCP servers over Streamable HTTP can use it. It’s designed to work seamlessly with popular AI assistants like Claude, ChatGPT, Cursor, and more.

What can you do with Kondo's LinkedIn MCP server?

  • Chat search — Find chats by name or message text, and read whole conversations
  • Reply drafting — Draft replies in your chats for you to review and send from Kondo
  • Inbox organization — Label chats into folders, archive what's done, and set reminders to follow up
  • Connection lookup — Search your connections by name, company, title or school, and keep notes on them
  • Invite handling — See pending connection invites, and accept or ignore them
  • Snippets — Use and create saved reply templates with smart placeholders

The server reaches your inbox through Kondo running in your browser, so your messages stay in your browser rather than on Kondo's servers. Your agent reads the messages Kondo has already stored first, and only goes to LinkedIn itself when it needs more, one request at a time.

This page is for LinkedIn, which Kondo runs in your browser. For WhatsApp, which runs in the Kondo desktop app, see MCP setup for the desktop app.

Set up Kondo's LinkedIn MCP server

Before you connect

Kondo's LinkedIn MCP server is part of the Business plan. Check your plan in Kondo's settings, and upgrade there or on the pricing page if you need to.

  1. Sign in to Kondo at app.trykondo.com in Chrome, Edge, Brave or another Chromium browser.
  2. Add the Kondo browser extension when Kondo asks for it, and wait until your LinkedIn inbox shows in Kondo.
  3. Keep Kondo open in one browser tab while your agent works. The server only answers while that tab is open.

Check that your agent is connected

Ask your agent: "List my Kondo inboxes." It should reply with your LinkedIn inbox and the folders you've made with labels. This only reads, so it changes nothing. If the agent has no Kondo tools or the request times out, see Troubleshooting.

Give your agent the Kondo skill

The Kondo skill teaches your agent to use the tools well: when to read stored messages, when to fetch more from LinkedIn, and how to stay within LinkedIn's limits. Save it as SKILL.md in your agent's skills folder, or paste it into the agent's instructions.

https://www.trykondo.com/skills/kondo-linkedin.md

Read the skill.

How to use Kondo's LinkedIn MCP server

Automatically draft LinkedIn DMs

PromptWhat happens
"Draft a reply to my latest message from Sarah Chen."Reads the chat and saves a reply as a draft in it.
"Draft a follow-up for every chat labeled Lead where I sent the last message more than 3 days ago."Finds the matching chats and saves a follow-up draft in each.
"Draft polite replies to my unread recruiter messages saying I'm not looking right now."Picks out recruiter chats and drafts a reply in each.
"Draft a reply to Alex suggesting a call, and leave the time for me to fill in."Drafts the reply with a {{day and time}} gap. Kondo asks before sending a message that still has one.

Organize LinkedIn DMs into folders

In Kondo, labels are your folders: each label gets its own inbox in the left sidebar, and a chat can sit in several. Your agent can create labels, sort chats into them, archive what's done and set reminders to bring a chat back.

PromptWhat happens
"Create Hot, Warm and Cold labels and sort my Lead chats into them."Creates the three labels and adds each lead chat to one.
"Label all recruiter messages as Recruiter."Finds recruiter chats and adds the label, so they collect in a Recruiter folder.

Triage unread LinkedIn messages

PromptWhat happens
"Show me my unread messages."Returns a prioritized summary of your unread chats.
"Summarize my unread messages and tell me which ones need a reply today."Reads your unread chats and lists the ones waiting on you, most urgent first.

Follow up on LinkedIn conversations

PromptWhat happens
"Go through my chats from the last 3 days and set reminders for anything I need to follow up on."Finds chats that need a follow-up and sets a reminder on each.
"Which chats from this week am I still waiting on a reply to?"Lists chats where you sent the last message and haven't heard back.

Find people in your LinkedIn network

PromptWhat happens
"Find my connections at Acme Corp."Searches your connections by company and lists the people.
"Who did I talk to about fundraising last month?"Searches your chats for the topic and lists the people and conversations.

Manage LinkedIn connection invites

PromptWhat happens
"Which invites are waiting for me, and who sent them?"Lists your pending connection invites.
"Accept the invites from founders and ignore the ones from recruiters."Reviews each invite and accepts or ignores it, one at a time.

Keep CRM notes on LinkedIn contacts

PromptWhat happens
"Add a note to Priya Shah's connection: met at SaaStr, interested in the team plan."Saves the note on her connection in Kondo.
"Summarize my notes on everyone labeled Investor."Reads the notes on those connections and summarizes them.

What Kondo's LinkedIn MCP server can and can't do

  • It never sends. Your agent saves drafts; only you send messages, from Kondo.
  • Some actions reach LinkedIn. Archiving, reminders and invite responses change your LinkedIn inbox. Labels, notes, drafts and snippets stay in Kondo.
  • It stays within LinkedIn's limits. Most reads use the messages Kondo has stored. Requests that go to LinkedIn run one at a time, a few seconds apart, so your account doesn't look automated.
  • Your messages stay in your browser. Commands and responses pass through Kondo's relay in memory and aren't stored. See the Privacy Policy.
  • It needs Kondo open. With no Kondo tab open, or more than one, your agent's requests fail.

Kondo LinkedIn MCP tools

Inbox and chats

ToolDescription
list_inboxesList inboxes, labels, and filters
list_inboxList chats in an inbox with filters (unread, date range, awaiting reply)
list_chatsSearch chats by person name or message text (searches what Kondo has stored; can fall back to searching LinkedIn directly)
read_chatRead message history for one or more chats
load_chatFetch 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

ToolDescription
set_chat_draftSave a draft reply (does not send — you review and send manually)
set_chat_labelAdd, remove, or replace labels on chats
set_chat_archivedArchive or restore chats
set_chat_reminderSnooze chats until a future time (archives them until the reminder is due)

Connections

ToolDescription
list_connectionsSearch connections by name, company, title, or school
read_connectionRead the CRM-style note on a connection
set_connection_noteSet or append to a connection's note
set_connection_labelAdd, remove, or replace labels on connections

Invites and snippets

ToolDescription
list_invitesList pending connection invites
set_invite_responseAccept or ignore invites
list_snippetsList saved reply templates
read_snippetRead a snippet's full content
set_snippetCreate or update a snippet with smart placeholders
set_labelCreate or rename a label

Troubleshooting problems with Kondo's LinkedIn MCP server

ProblemFix
Your agent has no Kondo tools, or requests time outOpen Kondo in one browser tab, close any others, and try again. Check that your plan is Business.
Sign-in failsRevoke the agent under Settings > MCP, then connect again. In Claude Code, run claude mcp logout kondo first.
Claude Code says No MCP server named "kondo"The server was added in another folder. Add it again with --scope user.
Commands stop working mid-chatRefresh the Kondo tab and try again. The extension must stay running.

Disconnect an AI agent from Kondo

Go to Settings > MCP in Kondo and click Revoke next to the agent. Its access ends immediately.