SuiteCRM MCP Server

What it does

Bridges AI assistants like Claude to your SuiteCRM 8.x instance via the JSON API (v8). Lets the AI create, search, update, and convert leads; manage contacts and account relationships; and perform CRUD operations across any SuiteCRM module — all through natural language.

Tools

• create_lead — Create new lead records with full field validation
• search_leads — Search leads with flexible criteria and pagination
• update_lead_status — Update lead status, notes, and assignment
• convert_lead — Convert leads to accounts, contacts, and opportunities
• create_contact — Create new contact records
• search_contacts — Search contacts with advanced filtering
• update_contact — Update contact information
• link_contact_to_account — Create contact-account relationships
• get_available_modules — List all SuiteCRM modules
• get_entry_list / get_entry / set_entry / update_entry / delete_entry — Generic CRUD on any module
• get_relationships / set_relationship — Manage record relationships
• get_module_fields — Retrieve field definitions and metadata

Installation

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "suitecrm": {
      "command": "mcp-server-suitecrm",
      "env": {
        "SUITECRM_URL": "https://your-suitecrm-instance.com/legacy",
        "SUITECRM_USERNAME": "your-api-username",
        "SUITECRM_PASSWORD": "your-api-password",
        "SUITECRM_CLIENT_ID": "your-oauth-client-id",
        "SUITECRM_CLIENT_SECRET": "your-oauth-client-secret"
      }
    }
  }
}

Requires SuiteCRM 8.x with JSON API enabled and an OAuth2 client configured in Admin.

Supported hosts

Confirmed: Claude Desktop.