CiviCRM MCP Server

What it does

This server provides AI assistants, such as Claude Desktop, with direct programmatic access to CiviCRM data. It allows the AI to search and retrieve contacts, manage activities, and handle donations while offering deep support for custom fields.

Tools

• get_contacts: Search and retrieve contacts including custom fields.
• create_contact: Create new contacts with custom field support.
• update_contact: Update existing contacts and their custom fields.
• list_custom_fields: List all available custom fields for any entity type.
• get_activities: Retrieve activities and associated custom fields.
• create_activity: Create new activities with custom fields.
• get_contributions: View donations and contributions.
• create_contribution: Record new donations with custom fields.
• get_events: List CiviCRM events.
• get_memberships: View memberships.
• system_info: Check the current status of the CiviCRM instance.

Installation

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "civicrm": {
      "command": "civicrm-mcp-server",
      "env": {
        "CIVICRM_BASE_URL": "https://your-civicrm-site.com",
        "CIVICRM_API_KEY": "your-api-key-here"
      }
    }
  }
}

Supported hosts

• Claude Desktop