Copper CRM MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Copper CRM MCP Server Give me a pipeline review: open deals closing this quarter, by stage, with total value."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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: Copper CRM MCP Server
Tools
Tool | What it does | Writes? |
| Account, API user, and all users with IDs | No |
| Contacts by name, email, company, tags, owner, location, last contact | No |
| One contact by exact email | No |
| Companies by name, tags, owner, location | No |
| Pipelines with stage IDs, names and win probability | No |
| Deals by status, pipeline, stage, owner, value, close date, staleness. Returns totals by status and stage | No |
| One deal with all fields | No |
| Create a deal | Yes |
| Move stage, mark Won/Lost, change value, close date or owner | Yes |
| Tasks by owner, status, due date, deal | No |
| Create a task linked to a record | Yes |
| Mark a task Completed | Yes |
| Add a note (or call, meeting...) to a record | Yes |
| Activity feed for a record or date range, or the activity types | No |
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
In Copper, go to Settings > API Keys and generate a key.
Build it:
git clone https://github.com/OfirOhan/copper-mcp.git
cd copper-mcp && npm install && npm run buildClaude 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.jsFor Cursor and other clients, use the same command with the variables in the environment.
Variable | Default | Notes |
| (required) | API key from Settings > API Keys |
| (required) | Email of the user who generated the key |
|
| Override for testing |
Development
npm install
npm test # builds, runs unit tests and an end-to-end MCP stdio test against a fake Copper APIThe 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
Available Tools
14 toolscomplete_taskComplete taskCIdempotent
Mark a task as Completed.
Inputs: task_id (required).
create_opportunityCreate opportunityA
Create a new deal. Use list_pipelines for pipeline and stage IDs and get_account_info for user IDs.
Inputs: name (required), tags, status, details, +8 more.
create_taskCreate taskC
Create a task, optionally linked to a person, company, lead or opportunity.
Inputs: name (required), tags, details, due_date, +5 more.
find_person_by_emailFind person by emailARead-only
Look up one contact by exact email address. Returns the full person record.
Inputs: email (required).
get_account_infoAccount, me and usersARead-only
Get the Copper account, the API user, and all users with their IDs. Use the user IDs as assignee_id in other tools.
Inputs: no named parameters.
get_opportunityGet opportunityBRead-only
Get one deal with all fields, including custom fields.
Inputs: opportunity_id (required).
list_activitiesList activitiesBRead-only
Recent activity (notes, emails, calls, meetings, stage changes) for a record, or across the account in a date range. Set types=true to list activity types instead.
Inputs: since, types, until, page_size, +3 more.
list_pipelinesList pipelinesARead-only
List pipelines with their stages (id, name, win probability). Needed to move deals between stages.
Inputs: no named parameters.
log_activityLog note or activityA
Add a note (default) or another user activity type (call, meeting...) to a person, company, lead or opportunity. Use list_activities with types=true to see activity type IDs.
Inputs: details (required), parent_id (required), parent_type (required), activity_date, +1 more.
search_companiesSearch companiesCRead-only
Search companies by name, tags, assignee or location.
Inputs: city, name, tags, country, +5 more.
search_opportunitiesSearch opportunities (deals)ARead-only
Search deals by name, status, pipeline, stage, owner, company, value or close date. Returns totals by status and stage (count and value) and a compact list with stage names instead of IDs. Good for pipeline reviews and forecasts.
Inputs: raw, name, tags, sort_by, +14 more.
search_peopleSearch peopleBRead-only
Search contacts (people) by name, email, company, tags, assignee or location. Returns a compact list.
Inputs: raw, city, name, tags, +10 more.
search_tasksSearch tasksBRead-only
Search tasks by owner, status, due date or related deal. Good for 'what's overdue for me?'.
Inputs: sort_by, statuses, due_after, page_size, +5 more.
update_opportunityUpdate opportunityAIdempotent
Update a deal: move it to another stage, mark it Won/Lost, change value, close date, owner or name. Only the fields you pass are changed.
Inputs: opportunity_id (required), name, tags, status, +10 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools target a distinct resource+action (search_opportunities vs get_opportunity vs create/update_opportunity are clearly separable). The only mild overlap is search_people vs find_person_by_email, since find_person_by_email is essentially a constrained lookup, but the descriptions clarify the difference (compact list vs full record).
All 14 tools follow a consistent snake_case verb_noun pattern (search_people, get_opportunity, create_task, list_activities, log_activity). Verbs are used predictably for their action type across resources.
14 tools is well within a sensible range and each earns its place across the CRM's core entities (people, companies, deals, tasks, activities, pipelines). No redundant or filler tools.
Coverage is strong for deals, tasks, and activities (create/search/get/update/complete), but there is no way to create or update people or companies, and no delete operations anywhere. These are notable gaps for a CRM surface and will force agents to work around missing write paths.
Maintenance
Related MCP Connectors
Read and write Copper CRM people, companies, opportunities and activities.
Connect AI to your Attio CRM. Manage contacts, companies, deals, and sales pipelines. Create tasks…
Open-source CRM your AI agents can write to: companies, people, opportunities, tasks and notes.
CRM, inbox, meetings, revenue intelligence, analytics and automations for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with amoCRM, providing access to deals, contacts, companies, notes, tasks, and custom fields via natural language.MIT
- AlicenseAqualityDmaintenanceEnables AI agents to read and manage Copper CRM data, including searching people, companies, and opportunities, listing pipelines, and logging activities or creating tasks.7MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to interact with a CRM covering companies, people, leads, deals, and more, with role checks, scoped agent keys, approval gates, and a shared audit trail.AGPL 3.0
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to read and act on SmartAgent real estate CRM data, such as finding leads, creating tasks, moving deals through pipelines, looking up property listings, and leaving notes.MIT