Coherence MCP server
✓ VerifiedAllows AI clients to interact with your Coherence CRM agent to manage records, outreach items, and automate tasks like drafting emails or creating reminders.
Also known as getcoherence/mcp-server, mcp-server, @coherenceos/mcp-server
- Stars
- 2
- Tools
- 13
- Downloads, 30 days
- 188
- Latest version
- 0.2.3
- Last commit
- Aug 12, 2026
- License
- MIT
What is Coherence MCP?
Coherence allows AI clients to interact with your Coherence CRM agent to manage records, outreach items, and automate tasks like drafting emails or creating reminders. It exposes 13 tools, such as chat_with_agent, list_modules, list_module_fields.
Summary generated from the project's README
About Coherence MCP server
Managing CRM records and outreach tasks directly from your AI chat interface is what this server enables. By connecting to a Coherence workspace, developers can use clients like Claude Desktop, Cursor, or Cline to interact with their CRM data. The setup requires a Coherence API key and is configured via a JSON snippet in your local MCP client settings.
The primary way to interact with the system is through the chat_with_agent tool, which allows you to communicate with the Nash agent to perform complex actions like drafting emails, setting reminders, or creating landing pages. For more granular control, the server provides specific tools to list modules, manage records through creation or updates, and handle outreach items such as blog articles and LinkedIn posts.
All actions performed through the agent remain subject to your workspace approval rules, ensuring that tasks like sending emails or posting to social media follow your established security protocols. You can also restrict the API key's capabilities using specific scopes for records, collaboration, agents, or workspace metadata.
What you can do with it
- 1Automate email and reminder creationAsk your AI client to draft follow-up messages for recent leads and schedule a reminder for the next step.
- 2Query CRM data and dealsRequest a filtered list of high-value opportunities from your database.
Written from the project's README. Every use case is checked against a quote from it.
How to install Coherence MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Coherence MCP in Claude Code
$ claude mcp add --env 'COHERENCE_API_TOKEN=<YOUR_COHERENCE_API_TOKEN>' mcp-server -- npx -y @coherenceos/mcp-serverInstall Coherence MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@coherenceos/mcp-server"
],
"env": {
"COHERENCE_API_TOKEN": "<YOUR_COHERENCE_API_TOKEN>"
}
}
}
}Install Coherence MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@coherenceos/mcp-server"
],
"env": {
"COHERENCE_API_TOKEN": "<YOUR_COHERENCE_API_TOKEN>"
}
}
}
}Install Coherence MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@coherenceos/mcp-server"],"env":{"COHERENCE_API_TOKEN":"<YOUR_COHERENCE_API_TOKEN>"}}'Install Coherence MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@coherenceos/mcp-server"
],
"env": {
"COHERENCE_API_TOKEN": "<YOUR_COHERENCE_API_TOKEN>"
}
}
}
}Install Coherence MCP in Codex
$ codex mcp add mcp-server --env 'COHERENCE_API_TOKEN=<YOUR_COHERENCE_API_TOKEN>' -- npx -y @coherenceos/mcp-serverInstall Coherence MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@coherenceos/mcp-server"] [mcp_servers.mcp-server.env] COHERENCE_API_TOKEN = "<YOUR_COHERENCE_API_TOKEN>"
Install Coherence MCP in Gemini CLI
$ gemini mcp add -s user -e 'COHERENCE_API_TOKEN=<YOUR_COHERENCE_API_TOKEN>' mcp-server npx -- -y @coherenceos/mcp-serverInstall Coherence MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@coherenceos/mcp-server"
],
"env": {
"COHERENCE_API_TOKEN": "<YOUR_COHERENCE_API_TOKEN>"
}
}
}
}Coherence MCP tools 13
Detected from the READMEchat_with_agentlist_moduleslist_module_fieldslist_recordsget_recordcreate_recordupdate_recorddelete_recordlist_outreach_itemsget_outreach_itemcreate_outreach_itemupdate_outreach_body
| chat_with_agent | — | |
| list_modules | — | |
| list_module_fields | — | |
| list_records | — | |
| get_record | — | |
| create_record | — | |
| update_record | — | |
| delete_record | — | |
| list_outreach_items | — | |
| get_outreach_item | — | |
| create_outreach_item | — | |
| update_outreach_body | — |
Show all 13 toolsShow fewer tools
update_outreach_item
| update_outreach_item | — |
Configuration
COHERENCE_API_TOKENRequiredSecretAPI key from your Coherence workspace (Settings → API Keys). Starts with sk_live_.
COHERENCE_API_URLAPI base URL. Defaults to https://api.getcoherence.io/v1.
| Name | Description | |
|---|---|---|
| COHERENCE_API_TOKEN | API key from your Coherence workspace (Settings → API Keys). Starts with sk_live_. | RequiredSecret |
| COHERENCE_API_URL | API base URL. Defaults to https://api.getcoherence.io/v1. |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablegetcoherence/mcp-server is public and reachablegithub.com/getcoherence/mcp-server ↗Pass
- Package names this repository as its source@coherenceos/mcp-server names getcoherence/mcp-server as sourcenpmjs.com/package/@coherenceos/mcp-server ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-12github.com/getcoherence/mcp-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @coherenceos/mcp-serverPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@coherenceos/mcp-server
MCP (Model Context Protocol) server that exposes Coherence as tools for Claude, Cursor, Cline, and other MCP-compatible clients.
The headline: chat_with_agent — send a message to your Coherence agent (Nash) from Claude Desktop and it can draft emails, create reminders, update records, post to social, create landing pages, and more, all under your workspace's approval rules.
Quickstart
1. Create an API key
In Coherence, go to Settings → API Keys → Create new key. Copy the sk_live_… value — it's only shown once. The Coherence UI will hand you a ready-to-paste JSON snippet that you can drop straight into your MCP client config.
2. Add to your MCP client
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"coherence": {
"command": "npx",
"args": ["-y", "@coherenceos/mcp-server"],
"env": {
"COHERENCE_API_URL": "https://api.getcoherence.io/v1",
"COHERENCE_API_TOKEN": "sk_live_..."
}
}
}
}
Cursor / Cline / Continue / Windsurf: same JSON, dropped into each tool's MCP settings file.
3. Talk to your workspace
Restart your MCP client, then try:
"Ask my Coherence agent to draft a follow-up email to the leads I created this week."
"List my open deals over $50k."
"Create a contact for Jane Doe at Acme Corp, then remind me to follow up next Tuesday."
Available tools
| Tool | What it does |
|---|---|
chat_with_agent |
Send a message to a Coherence agent; the agent uses its own toolset (email, reminders, calendar, social, landing pages, approvals, etc.) and returns its response |
list_modules |
List CRM modules in the workspace |
list_module_fields |
List fields on a module — useful before creating/updating records |
list_records |
List records in a module with search + pagination |
get_record |
Get a single record by ID |
create_record |
Create a new record |
update_record |
Update a record's fields |
delete_record |
Soft-delete a record (recoverable from trash) |
list_outreach_items |
List blog articles, LinkedIn posts, emails, etc. |
get_outreach_item |
Get a single outreach item, including its MDX content |
create_outreach_item |
Create a new outreach item |
update_outreach_body |
Update the MDX body of an outreach item |
update_outreach_item |
Update outreach metadata (title, status, etc.) |
For everything else — calendar events, sending email, posting to social, creating landing pages, managing approvals — use chat_with_agent. The agent has the full toolset.
Environment variables
| Variable | Required | Default | Description |
|---|---|---|---|
COHERENCE_API_TOKEN |
Yes | — | API key (sk_live_…) from your Coherence workspace |
COHERENCE_API_URL |
No | https://api.getcoherence.io/v1 |
API base URL |
Scopes
When you create an API key in Coherence you can pick scopes. If you tick none, the key inherits your full user permissions (the default). If you tick some, the key is restricted to those:
records:read,records:write— module recordscollab:read,collab:write— Collab documentsagents:read,agents:write— agents andchat_with_agentworkspace:read— modules, fields, workspace metadata
Approval gates (sendEmail, postToSocial, etc.) are enforced inside the Coherence platform regardless of which scopes a key holds — an API key cannot bypass them.
Links
- Coherence: https://getcoherence.io
- MCP landing page: https://getcoherence.io/mcp
- Docs & quickstart: https://getcoherence.io/docs/mcp/quickstart
- API docs (OpenAPI): https://api.getcoherence.io/v1/openapi.json
- Issues: https://github.com/getcoherence/mcp-server/issues
Coherence MCP questions
How do I add Coherence MCP to Claude Code?
Run claude mcp add --env 'COHERENCE_API_TOKEN=<YOUR_COHERENCE_API_TOKEN>' mcp-server -- npx -y @coherenceos/mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add Coherence MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Coherence MCP provide?
It exposes 13 tools, including chat_with_agent, list_modules, list_module_fields, list_records, get_record.
How do I use the Coherence agent for tasks like sending emails or posting to social?
You can use the chat_with_agent tool to send messages to your Coherence agent, which can then handle emails, social posts, and more.
Can an API key bypass approval gates for sending emails or social posts?
No, approval gates are enforced within the Coherence platform and cannot be bypassed by an API key.