Civicrm Mcp

Name: Civicrm Mcp
Author: YogiAdhik

by YogiAdhikcommunityv0.1.2

An MCP server that lets MCP-compatible clients interact with a CiviCRM installation through APIv4 over stdio. It provides read, write, introspection, and diagnostic tools for contacts, contributions, events, memberships, groups, notes, activities, and saved searches.

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

GitHub Repository

Install & configure

Prerequisites

required
Install Node.js 18.17 or later
Node.js 18.17+ is required to run the MCP server.
required
Have a CiviCRM installation available
Requires a CiviCRM 5.47+ installation (tested against 5.59+) on Drupal, WordPress, Backdrop, or Standalone.
required
Create a dedicated CiviCRM bot user and API key
Create a CMS user and matching CiviCRM contact for this integration, grant the desired CiviCRM permissions, and generate an API key for that contact. If your site uses the site-key guard, obtain the CiviCRM site key as well.

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `civicrm-mcp` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Install Node.js 18.17 or later** — Node.js 18.17+ is required to run the MCP server.
- **Have a CiviCRM installation available** — Requires a CiviCRM 5.47+ installation (tested against 5.59+) on Drupal, WordPress, Backdrop, or Standalone.
- **Create a dedicated CiviCRM bot user and API key** — Create a CMS user and matching CiviCRM contact for this integration, grant the desired CiviCRM permissions, and generate an API key for that contact. If your site uses the site-key guard, obtain the CiviCRM site key as well.

Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","civicrm-mcp"]
- required environment variables:
  - `CIVICRM_BASE_URL`: Base URL of your CiviCRM site. (example: `<your-civicrm-base-url>`)
  - `CIVICRM_CMS`: CMS type for the CiviCRM install. Supported values: drupal, wordpress, standalone, backdrop. (example: `<your-civicrm-cms>`)
  - `CIVICRM_API_KEY`: API key for the dedicated CiviCRM bot contact. (example: `<your-civicrm-api-key>`)
- optional environment variables:
  - `CIVICRM_SITE_KEY`: CiviCRM site key, only needed if the site-key guard is enabled on the target site. (example: `<your-civicrm-site-key>`)
  - `CIVICRM_AUTH_MODE`: Authentication mode. Use authx by default, or legacy for pre-AuthX sites. (example: `<your-auth-mode>`)
  - `CIVICRM_ALLOW_WRITES`: Enable write tools when set to true. Defaults to false. (example: `<true-or-false>`)
  - `CIVICRM_ALLOW_DELETES`: Enable delete-style operations when set to true. Defaults to false. (example: `<true-or-false>`)
  - `CIVICRM_ALLOW_GENERIC_API`: Enable the generic civicrm_api4 passthrough tool when set to true. Defaults to false. (example: `<true-or-false>`)
  - `CIVICRM_DRY_RUN_DEFAULT`: When true, write and delete operations are dry-run by default. Defaults to false. (example: `<true-or-false>`)
  - `CIVICRM_TOOLS_ENABLED`: Comma-separated allowlist of tool names to register. Empty means all tools are enabled unless disabled. (example: `<comma-separated-tool-names>`)
  - `CIVICRM_TOOLS_DISABLED`: Comma-separated denylist of tool names to disable. Takes precedence over CIVICRM_TOOLS_ENABLED. (example: `<comma-separated-tool-names>`)

Note: README also shows a local build path (`npm install && npm run build`), but the simpler portable MCP client configuration uses `npx -y civicrm-mcp`, which is preferred.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: README also shows a local build path (`npm install && npm run build`), but the simpler portable MCP client configuration uses `npx -y civicrm-mcp`, which is preferred.

Tools (25)

civicrm_system_info

Checks connectivity/version sanity and resolves the authenticated bot contact.

civicrm_whoami

Resolves the bot contact and probes which entities it can read.

civicrm_find_contacts

Searches contacts by name or primary email.

civicrm_get_contact

Fetches one contact by id with default fields.

civicrm_get_relationships

Lists a contact's relationships with direction resolved.

civicrm_get_contributions

Lists contributions with filters and running sum.

civicrm_list_events

Lists events, defaulting to upcoming only.

civicrm_list_saved_searches

Discovers SearchKit SavedSearches built by admins.

civicrm_run_saved_search

Executes a SavedSearch by name via SearchDisplay.run.

civicrm_list_entities

Lists every APIv4 entity available on the install, including extensions.

civicrm_describe_entity

Returns fields and actions for an entity.

civicrm_describe_field_options

Returns the option list for one field.

civicrm_create_contact

Environment variables

CIVICRM_BASE_URLrequiredBase URL of the CiviCRM site.

CIVICRM_CMSrequiredCMS type for the install, such as drupal, wordpress, standalone, or backdrop.

CIVICRM_API_KEYrequiredAPI key for the dedicated CiviCRM bot contact.

Prerequisites

• Node.js 18.17

Packages

civicrm-mcp

npmv0.1.2transport: stdio

Details

Language: TypeScript
License: MIT
Released: Apr 24, 2026
Last commit: May 18, 2026
Registry name: io.github.YogiAdhik/civicrm-mcp

Related Servers

Context7

Up-to-date code docs for any prompt

59.8k

Openmetadata Mcp

Official OpenMetadata MCP: governed context and business semantics for AI assistants and agents.

14.6k

Tolgee

Your app's translations in Tolgee: search keys, create translations, trigger machine translation

4.0k

Civicrm Mcp

Install & configure

Prerequisites

Install in your client

Tools (25)

Environment variables

Prerequisites

Packages

Details

Categories

Related Servers