Civicrm-mcp Server

Model Context Protocol server for CiviCRM — AuthX-first, schema-introspected, write-gated.

Local serverstdio

What is the Civicrm-mcp Server?

Civicrm-mcp is an MCP integration. Model Context Protocol server for CiviCRM — AuthX-first, schema-introspected, write-gated.

Packages and local setup

The published npm package is civicrm-mcp, version 0.1.2. Its declared MCP transport is stdio.

The package declares CIVICRM_BASE_URL (required): Base URL of the CiviCRM install, e.g. https://crm.example.org. No trailing slash.; CIVICRM_API_KEY (required): API key of the contact the server authenticates as. Keep it on a dedicated 'MCP Bot' contact with minimum permissions.; 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..

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 0.1.2 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related developer tools MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
CIVICRM_BASE_URLBase URL of the CiviCRM install, e.g. https://crm.example.org. No trailing slash.Yes
CIVICRM_API_KEYAPI key of the contact the server authenticates as. Keep it on a dedicated 'MCP Bot' contact with minimum permissions.Yes
CIVICRM_CMSCMS host: drupal, wordpress, standalone, or backdrop.Optional
CIVICRM_SITE_KEYOptional — only needed if the site enables the AuthX site-key guard.Optional
CIVICRM_AUTH_MODEauthx (default, recommended) or legacy for pre-5.36 installs.Optional
CIVICRM_ALLOW_WRITESSet to 'true' to enable create / update / save / submit actions. Off by default.Optional
CIVICRM_ALLOW_DELETESSet to 'true' to enable delete / replace actions. Off by default.Optional