
Concord MCP Server: Let Claude Code, Codex and Cursor Agents Work Together
Lets coding agents in different apps claim files, message each other and hand work over.
Concord lets coding agents such as Claude Code, Codex, Cursor and Gemini CLI see each other's work and send each other messages. It keeps a shared record of who owns which files, what was decided and what is ready for review, so two agents do not edit the same thing. It runs on your computer and needs no account. Its setup command also installs helper plugins and hooks in your agent apps, so read the safety section first.
Good for
- Developers who run Claude Code and Codex or Cursor on the same repository
- Teams who want a hand-off record and a review summary for agent work
- Anyone tired of two agents editing the same file
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install Concord MCP
Claude Code
- 1
Copy this prompt.
Add the Concord MCP server to Claude Code. Run this command: npm install -g @concord-ai/concord-mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js 22.12+.
Run concord setup inside the repository, then restart your agent apps. It registers Concord for this app for you; the generated entries after it are an alternative that sets up the MCP server only.
From the project README. Source.
Tools
Claims a task and warns you if another agent is already on it
Marks the agent as present and claims the files or area it is about to change. If another agent already holds part of that area, the answer says so before any edits happen. It also accepts work that was assigned to this agent.
Try: “Before you edit src/app/page.tsx, claim it and tell me if anyone else is working there.”
Write ·
start_workShows who is working, on what, and what messages are waiting
Reads the shared state: which agents are present, which tasks and claims exist, and which of them look stale. It can also open one agent's inbox or outbox, or one prompt and reply thread. It only reads and is marked read-only.
Try: “Who else is working in this repo right now, and are any claims stale?”
Read ·
inspect_workSaves notes on a task or sends a live message to another agent
Adds decisions, assumptions or findings to a task so they outlast the session. It can also send a prompt to another agent, such as one in Codex or Cursor, or reply to one. Delivery fails with an error if that agent cannot be reached.
Try: “Tell the Codex agent I will keep the page and it should build the API under src/app/api.”
Write ·
update_workAssigns, hands off, accepts or releases a task between agents
Changes who owns a task. Assigned work stays unowned until the named agent accepts, and a handoff offer leaves ownership with the sender until the other side accepts. Every change is logged and checked against the task's version number, so two agents cannot both win.
Try: “Hand the login fix to the reviewer agent with the test results attached.”
Write ·
transfer_workRecords the result and marks a task ready for review or done
Stores what was done and the evidence for it, then either leaves the task open as a handoff, marks it ready for review or closes it. The saved record feeds the handoff and review files in the repo's .concord folder.
Try: “Mark the checkout refactor review-ready and list the tests I ran.”
Write ·
finish_work
Read from the source code
Permissions
medium risk · 5 things to watch
Medium risk
Concord can write notes to a hidden folder in your repo and send prompts to other agents, but its five tools have no delete action. Its setup command also changes agent config files and installs hooks, so run it in a repository you are happy to change.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
Setup edits agent config and adds hooks
concord setup writes MCP entries, instruction files and hooks for several agents, including a Claude Code PreToolUse check that runs before tool calls. It merges into existing files and is safe to re-run, but review the changes in git or your home folder. github.com
The server can repair agent plugins and hooks when it starts
On start, the server runs concord adapters ensure in the background for the agent app it was launched from. It changes files only if you opted in to automatic adapters during concord setup (otherwise it just prints a notice). When on, it can write: a link to the bundled plugin (Claude Code, a link in ~/.gemini/extensions/concord-relay for Gemini CLI, ~/.cursor/extensions/get-concord-ai.concord-relay plus ~/.cursor/hooks.json for Cursor); Codex MCP entry and hooks in config.toml, then it starts and enables the Codex app-server daemon with remote control; a Grok Build plugin via grok plugin install --trust; a Goose config.yaml entry; Copilot CLI ~/.copilot/mcp-config.json and hooks; Devin CLI MCP config and user hooks; Antigravity ~/.gemini/config/mcp_config.json and hooks. concord adapters status shows what is installed. github.com
Agents can send each other prompts
update_work delivers text straight into another agent's session, so a message from one agent becomes instructions for another. Only run Concord with agents you trust. github.com
Writes a .concord folder in your repo
Tasks, a handoff file, review packet and event log are saved in .concord at the repo root. Setup adds a .gitignore there so it is not committed by default. github.com
Sends anonymous usage statistics
Telemetry goes to getconcord.ai. Set CONCORD_TELEMETRY_DISABLED=1 or DO_NOT_TRACK=1 to switch it off. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only option is documented. Only inspect_work is marked read-only; the other four tools write to the local Concord store. |
|---|---|
| Talks to | getconcord.ai: anonymous usage statistics, unless you turn them off. registry.npmjs.org: daily update check. Concord Cloud, only if you run concord cloud login |
| Sign-in and keys | No account or key is needed in local mode. Concord Cloud sign-in is optional and separate. |
Questions
Is Concord official for Claude Code, Codex or Cursor?
No. Get-Concord-AI makes Concord as an independent project. It works across those tools but is not made by Anthropic, OpenAI or Cursor.
Which agents does Concord work with?
The README lists Claude Code, Codex, Cursor, Gemini CLI, Grok Build, Goose, Google Antigravity, GitHub Copilot CLI and Devin CLI. Any other MCP client can use the five tools over stdio, but gets no live message delivery.
Do I need an account or API key?
No. The local mode needs neither. Concord Cloud, which links agents on different machines, is optional and uses its own login.
What does concord setup change?
It creates a .concord folder, registers the MCP server in each supported agent's config and writes Concord instructions into files such as CLAUDE.md and AGENTS.md. With global mode on, it also edits your user-level instruction files. You can skip MCP registration with the no-MCP flag.
Is it free?
Yes. Concord is open source under the MIT license and the local mode costs nothing.
Does it collect data?
Yes, anonymous usage statistics by default. The project says it never sends code, file paths, message content or task content. Set CONCORD_TELEMETRY_DISABLED=1 to turn it off.
Can it run read-only?
No. Only the inspect tool is read-only. The other four tools write task state to the local store.
What do I need installed first?
Node.js 22.12 or newer. On macOS or Linux the project also offers a self-contained installer that bundles its own Node.
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
@concord-ai/concord-mcp- Registry
- npm
- Transport
- stdio
- Auth
- None
- Version
- 0.19.0
- License
- MIT
- Last commit
- Oct 30, 2026
- Open issues
- 31
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 7Hide
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com