honestcrm MCP server: connect AI agents to your CRM
The honestcrm MCP server is an endpoint that lets AI agents such as Claude, ChatGPT, Claude Code, and Cursor read and update your small business CRM. Use it as a Claude CRM, a ChatGPT CRM, or a Claude Code CRM: ask your agent to find a contact, log a call, or move a deal. It works with your permissions.
The server uses the Model Context Protocol (MCP), an open standard for connecting AI tools to other software. It lives at https://app.honestcrm.ai/api/mcp and uses Streamable HTTP. Claude and ChatGPT connect with OAuth, and Claude Code and Cursor connect with an agent key.
18 MCP tools for reading and updating your CRM
The server gives your agent 18 tools. Seven read data and eleven change it. Your agent client flags the write tools and asks you to confirm before it runs one.
The server also instructs the agent to search for duplicates before it creates a record, to confirm before a bulk change, and to link each record it touches in the console.
| Tool | What it does |
|---|---|
search | Find contacts, companies, and deals by name, email, or any text in the record. |
get_contact | Read one contact with its company, open deals, open tasks, and last five activities. |
get_company | Read one company, including its details and related records. |
get_deal | Read one deal with its stage, company, primary contact, open tasks, and last five activities. |
list_deals | List deals, filtered by pipeline, stage, or status (open, won, or lost). |
list_tasks | List tasks, filtered by assignee, contact, company, or deal. |
list_pipelines | List your pipelines with their ordered stages and the number of deals in each stage. |
| Tool | What it does |
|---|---|
create_contact | Add a contact. |
update_contact | Change a contact. |
create_company | Add a company. |
update_company | Change a company. |
create_deal | Add a deal. |
update_deal | Change a deal. |
move_deal_stage | Move a deal to another open stage. |
create_task | Add a follow-up task, linked to a contact, company, or deal. |
complete_task | Mark a task done. |
add_note | Record a note on a contact, company, or deal. |
log_call | Record a call on a contact, company, or deal. |
Five MCP prompts for common CRM work
MCP prompts are ready-made workflows. Your client lists them and you pick one to start, for example a weekly pipeline review.
| Prompt | What it does |
|---|---|
log_call_and_follow_up | Log a call, then create its follow-up tasks. |
weekly_pipeline_review | List open deals by stage and flag deals with no activity in 14 days. |
add_contact_from_signature | Turn an email signature or business card text into a contact. |
import_csv | Import a CSV file after you check the column mapping. |
prepare_for_meeting | Get a short brief on a contact or company before a meeting. |
Connect Claude or ChatGPT to your CRM
Claude and ChatGPT connect with OAuth. You sign in to honestcrm, and you do not copy a key.
Claude connector for claude.ai, Claude Desktop, and mobile
honestcrm is listed in the Claude connectors directory as HonestCRM. Claude Desktop and the Claude mobile apps use the same connectors as claude.ai, so you connect once.
Add the HonestCRM connector to Claude- Open the HonestCRM listing, or in Claude open Settings > Connectors, choose Browse connectors, and search for HonestCRM.
- Choose Connect.
- Sign in to honestcrm if you are not signed in.
- Review the request on the consent page and choose Allow.
To add a custom connector in Claude, or to connect ChatGPT, use this URL:
https://app.honestcrm.ai/api/mcpClaude custom connector
- Open Settings > Connectors and choose Add custom connector.
- Paste the URL above and save.
- Choose Connect, and sign in to honestcrm if you are not signed in.
- Review the request and choose Allow.
ChatGPT
- Turn on developer mode in the ChatGPT connector settings.
- Add a connector, paste the URL above, and choose OAuth for authentication.
- Sign in to honestcrm, review the request, and choose Allow.
The consent page shows the app name, the workspace, and your role. The app acts as you, with your permissions. Each connection appears in Settings > Agents, and you can revoke it there at any time. Machines that discover the server read the OAuth protected resource metadata.
Set up the CRM MCP server in Claude Code or Cursor
- In honestcrm, open Settings > Agents and create an agent. Give it a name, such as Claude Code.
- Copy the key, which starts with
hca_. honestcrm shows it once. - Add the server to your client with one of the snippets below, and replace
hca_your_keywith your key.
Claude Code
Run this command in your terminal.
claude mcp add --transport http honestcrm https://app.honestcrm.ai/api/mcp --header "Authorization: Bearer hca_your_key"Cursor
Add this to ~/.cursor/mcp.json.
{
"mcpServers": {
"honestcrm": {
"url": "https://app.honestcrm.ai/api/mcp",
"headers": {
"Authorization": "Bearer hca_your_key"
}
}
}
}Your agent works with your permissions
- An agent has the role, permissions, and record visibility of the user who created it, and it follows any later change to them.
- The console labels an agent's changes with your name and the agent's name, for example "Priya's agent: Claude Code". Your team can tell them from your own edits.
- Revoke an agent in Settings > Agents and it loses access, whether it connected with OAuth or a key.
Included on Free and Pro
- Agent access is on both plans. See pricing for each plan's limits.
- Writes count against the same plan limits as the console.
- honestcrm runs no model for agent access, so agent use does not use AI requests.