Civicrm Mcp
Query and safely mutate CiviCRM data from an agent using AuthX, live schema introspection, and write gates.
Overview
civicrm-mcp is a MCP server for the Build phase that provides AuthX-backed, schema-aware, write-gated access to CiviCRM for coding agents.
What is this MCP server?
- npm civicrm-mcp v0.1.2 with stdio transport
- AuthX-first authentication against CIVICRM_BASE_URL with API key on a dedicated low-privilege contact
- Schema-introspected tools so agents align with live CiviCRM entities
- Write-gated mutations to reduce accidental bulk changes from LLM tool calls
- CMS modes: drupal (default), wordpress, standalone, backdrop; optional site-key guard support
- Server version 0.1.2
- Transport: stdio
- Registry: npm identifier civicrm-mcp
What problem does it solve?
Letting an agent touch production CRM data feels dangerous without AuthX, schema-aware tools, and explicit write gates.
Who is it for?
Solo devs or tiny teams extending CiviCRM on Drupal/WordPress who need guarded agent access for support and integration tasks.
Skip if: Greenfield projects with no CiviCRM install, or teams that refuse API keys on dedicated bot contacts and write restrictions.
What do I get? / Deliverables
After configuring base URL, API key, and CMS mode, agents can introspect and interact with CiviCRM through bounded MCP tools.
- Schema-aligned MCP tools for CiviCRM read operations
- Controlled write paths when write gating allows agent-proposed changes
- Agent-friendly CRM context without manual API exploration scripts
Recommended MCP Servers
Journey fit
CRM MCP access is Build-time integration work when you connect membership, donation, or case data to custom apps and agent workflows. Integrations reflects API bridging to CiviCRM on Drupal, WordPress, Backdrop, or standalone—not frontend polish or launch distribution.
How it compares
CiviCRM API MCP with AuthX and write gates, not a generic spreadsheet CRM or marketing automation skill.
Common Questions / FAQ
Who is civicrm-mcp for?
Developers and one-person IT for nonprofits or membership orgs on CiviCRM who want MCP agents with AuthX and controlled writes.
When should I use civicrm-mcp?
Use it during Build integrations when automating lookups, explaining CRM structure to an agent, or applying reviewed updates via API.
How do I add civicrm-mcp to my agent?
Install civicrm-mcp from npm, set CIVICRM_BASE_URL and CIVICRM_API_KEY (and CMS/site-key vars as needed), then register the stdio MCP server in your client.