Copper CRM MCP Server

A Model Context Protocol server for Copper, the CRM for Google Workspace. It lets Claude, Cursor, ChatGPT and other AI agents search contacts and companies, review the pipeline, move deals between stages, and log notes and tasks.

Unofficial. This is a community project and is not affiliated with Copper. It was built from Copper's public Developer API docs.

What you can ask your agent

• "Give me a pipeline review: open deals closing this quarter, by stage, with total value."

• "Which open deals haven't changed stage since September?"

• "Move the Acme renewal to Proposal, set the close date to Nov 30, and add a note that I sent the revised quote."

• "Who at Globex is in the CRM, and when did we last talk to them?"

• "What tasks are overdue for me? Create a follow-up task for Dana for Friday."

• "Show me the last 10 activities on the Initech deal."

Related MCP server: amoCRM MCP

Tools

The server does the translation an LLM would otherwise get wrong. It accepts ISO dates and converts them to Copper's unix-second timestamps (and M/D/YYYY close dates), maps Open/Won/Lost/Abandoned to Copper's status IDs, swaps stage IDs for stage names, and returns compact records instead of full API payloads (use raw: true when you want everything). Write tools carry MCP annotations, so clients can ask before running them.

Setup

1. In Copper, go to Settings > API Keys and generate a key.

2. Build it:

git clone https://github.com/OfirOhan/copper-mcp.git
cd copper-mcp && npm install && npm run build

Claude Desktop

Add this to claude_desktop_config.json:

{
  "mcpServers": {
    "copper": {
      "command": "node",
      "args": ["/absolute/path/to/copper-mcp/dist/index.js"],
      "env": { "COPPER_API_KEY": "...", "COPPER_USER_EMAIL": "you@company.com" }
    }
  }
}

Claude Code / Cursor / other MCP clients

claude mcp add copper -e COPPER_API_KEY=... -e COPPER_USER_EMAIL=you@company.com -- node /path/to/copper-mcp/dist/index.js

For Cursor and other clients, use the same command with the variables in the environment.

Development

npm install
npm test   # builds, runs unit tests and an end-to-end MCP stdio test against a fake Copper API

The tests run on Node 20, 22 and 24 in CI.

Author

Built by Ofir Ohana, an AI agents engineer. Issues and PRs are welcome.

License

MIT