Model Context Protocol server for CiviCRM — AuthX-first, schema-introspected, write-gated.
Use this profile to copy client config, check auth requirements, review tools and resources, and compare related MCP servers before adding it to an AI client.
npx -y civicrm-mcp{
"CIVICRM_BASE_URL": "YOUR_VALUE_HERE",
"CIVICRM_API_KEY": "YOUR_SECRET_VALUE",
"CIVICRM_CMS": "drupal",
"CIVICRM_SITE_KEY": "YOUR_SECRET_VALUE",
"CIVICRM_AUTH_MODE": "authx",
"CIVICRM_ALLOW_WRITES": "false",
"CIVICRM_ALLOW_DELETES": "false"
}Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
{
"mcpServers": {
"io-github-yogiadhik-civicrm-mcp": {
"command": "npx",
"args": [
"-y",
"civicrm-mcp"
],
"env": {
"CIVICRM_BASE_URL": "YOUR_VALUE_HERE",
"CIVICRM_API_KEY": "YOUR_SECRET_VALUE",
"CIVICRM_CMS": "drupal",
"CIVICRM_SITE_KEY": "YOUR_SECRET_VALUE",
"CIVICRM_AUTH_MODE": "authx",
"CIVICRM_ALLOW_WRITES": "false",
"CIVICRM_ALLOW_DELETES": "false"
}
}
}
}~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonNo remote HTTP endpoint is advertised. Use the package or stdio setup shown in Install.
civicrm-mcp is an MCP server for Model Context Protocol server for CiviCRM — AuthX-first, schema-introspected, write-gated.. It supports STDIO transport.
Use the generated config in Install. This server runs with npx -y civicrm-mcp; add any required environment variables before starting your client.
Choose the Claude Desktop tab in Install and copy the config for npx -y civicrm-mcp. Add required environment variables before starting Claude Desktop.
Choose the Claude Code tab in Install and copy the config for npx -y civicrm-mcp. Add required environment variables before starting Claude Code.
Choose the Codex tab in Install and copy the config for npx -y civicrm-mcp. Add required environment variables before starting Codex.
Choose the Cursor or VS Code tab in Install and copy the config for npx -y civicrm-mcp. Add required environment variables before starting Cursor or VS Code.
civicrm-mcp uses STDIO transport. Use the package or command config in Install.
civicrm-mcp inventory is listed when the MCP endpoint exposes tools, resources, or prompts. Some servers require auth first.
civicrm-mcp is marked with Auth required by registry metadata auth. You may need provider login, an API key, a bearer token, or a session header.
| Package | Registry | Version | Inputs |
|---|---|---|---|
civicrm-mcpstdio | npm | 0.1.2 | Env: CIVICRM_BASE_URL required Env: CIVICRM_API_KEY required secret Env: CIVICRM_CMS Env: CIVICRM_SITE_KEY secret Env: CIVICRM_AUTH_MODE Env: CIVICRM_ALLOW_WRITES Env: CIVICRM_ALLOW_DELETES |