Civicrm MCP runs on your own machine — the client starts it, so there is no endpoint to ping. 59 installs a week from npm. Last commit 18 May 2026.
Model Context Protocol server for CiviCRM — AuthX-first, schema-introspected, write-gated.
Today is the operative word: we check Civicrm MCP every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add civicrm-mcp -e 'CIVICRM_BASE_URL=<CIVICRM_BASE_URL>' -e 'CIVICRM_API_KEY=<CIVICRM_API_KEY>' -- npx -y civicrm-mcp
{
"mcpServers": {
"civicrm-mcp": {
"command": "npx",
"args": [
"-y",
"civicrm-mcp"
],
"env": {
"CIVICRM_API_KEY": "<CIVICRM_API_KEY>",
"CIVICRM_BASE_URL": "<CIVICRM_BASE_URL>"
}
}
}
}
[mcp_servers.civicrm-mcp]
command = "npx"
args = ["-y", "civicrm-mcp"]
env = { CIVICRM_BASE_URL = "<CIVICRM_BASE_URL>", CIVICRM_API_KEY = "<CIVICRM_API_KEY>" }
{
"mcpServers": {
"civicrm-mcp": {
"command": "npx",
"args": [
"-y",
"civicrm-mcp"
],
"env": {
"CIVICRM_API_KEY": "<CIVICRM_API_KEY>",
"CIVICRM_BASE_URL": "<CIVICRM_BASE_URL>"
}
}
}
}
{
"servers": {
"civicrm-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"civicrm-mcp"
],
"env": {
"CIVICRM_API_KEY": "<CIVICRM_API_KEY>",
"CIVICRM_BASE_URL": "<CIVICRM_BASE_URL>"
}
}
}
}
Put your own values in place of
<CIVICRM_BASE_URL> (Base URL of the CiviCRM install, e.g. https://crm.example.org. No trailing slash), <CIVICRM_API_KEY> (API key of the contact the server authenticates as. Keep it on a dedicated 'MCP Bot' contact with minimum permissions).
The author’s registry entry marks them as required.
Optional settings from the registry entry, left out of the block above:
CIVICRM_CMS (CMS host: drupal, wordpress, standalone, or backdrop), CIVICRM_SITE_KEY (Optional — only needed if the site enables the AuthX site-key guard), CIVICRM_AUTH_MODE (authx (default, recommended) or legacy for pre-5.36 installs), CIVICRM_ALLOW_WRITES (Set to 'true' to enable create / update / save / submit actions. Off by default), CIVICRM_ALLOW_DELETES (Set to 'true' to enable delete / replace actions. Off by default).
MCP (Model Context Protocol) server for Appwrite
A Model Context Protocol server for Sitecore
A Model Context Protocol (MCP) server for esa.io
Wrap any CLI as a Model Context Protocol server - schema auto-inferred from --help.
A Model Context Protocol server for Wix AI tools
Model Context Protocol server for Forgejo, Codeberg and Gitea, in Rust
A Model Context Protocol (MCP) server for NuGet.
GitLab MCP (Model Context Protocol) server for AI agents
Answers built from our own checks of this server.