Claude Desktop + Insurance CRM: The Complete MCP Setup Guide for Agents

Step-by-step guide to wiring Claude Desktop into unLocked CRM via MCP — config file location, JSON schema, API key placement.

TL;DR

Add unLocked CRM to Claude Desktop's MCP config in under 3 minutes. Use your existing API key. Get full read/write access to contacts, policies, commissions, pipelines, and more from any Claude conversation.

Key Takeaways

  • Claude Desktop config lives at ~/Library/Application Support/Claude/ (macOS)
  • Same x-api-key as unLocked REST API — no new credential
  • Tool icon appears after restart, listing every CRM resource
  • MCP composes with web, files, and other MCP servers in one chat

Claude Desktop now supports the Model Context Protocol (MCP) natively, which means you can give Claude direct, real-time access to your insurance CRM data without any glue code. Here's the exact playbook.

Where the Config Lives

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows: %APPDATA%\Claude\claude_desktop_config.json. Open it in any text editor.

The MCP Server Block

Add an entry under mcpServers pointing at the unLocked MCP endpoint with your API key as a header. Restart Claude Desktop and you'll see the unLocked tool icon in the chat input.

The First 10 Prompts to Try

  1. "List my 10 most recent contacts and their lead source."
  2. "Show every Medicare policy renewing in the next 60 days."
  3. "Draft a Q1 check-in email for my top 5 commission earners."
  4. "Find contacts turning 65 in the next 90 days who don't have a policy yet."
  5. "Summarize my pipeline by stage and forecast Q1 close."
  6. "Create a task to call John Doe tomorrow at 2pm."
  7. "Pull commission statements from last month, group by carrier."
  8. "Find ACA clients whose income changed and need a SEP review."
  9. "Build a list of orphaned policies (no agent assigned)."
  10. "Draft a personalized SMS for every annual review due this week."

Why This Beats a Sidebar Chatbot

Embedded CRM chatbots are siloed — they only know what they've been wired to know. Claude Desktop with MCP can combine your CRM data with web research, calendar, files, and other MCP servers in a single conversation. That compositional power is what makes MCP the new standard.

Frequently Asked Questions

Does this require a paid Claude plan?

Claude Desktop supports MCP on all plans, including free. Pro is recommended for higher token limits when working over large books of business.

Can Claude write to the CRM?

Yes — create, update, and delete operations are all exposed. Use API keys with scoped permissions to limit what's writable.

Where This Fits In unLocked