Skip to content
honestcrm

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.

Read tools
ToolWhat it does
searchFind contacts, companies, and deals by name, email, or any text in the record.
get_contactRead one contact with its company, open deals, open tasks, and last five activities.
get_companyRead one company, including its details and related records.
get_dealRead one deal with its stage, company, primary contact, open tasks, and last five activities.
list_dealsList deals, filtered by pipeline, stage, or status (open, won, or lost).
list_tasksList tasks, filtered by assignee, contact, company, or deal.
list_pipelinesList your pipelines with their ordered stages and the number of deals in each stage.
Write tools
ToolWhat it does
create_contactAdd a contact.
update_contactChange a contact.
create_companyAdd a company.
update_companyChange a company.
create_dealAdd a deal.
update_dealChange a deal.
move_deal_stageMove a deal to another open stage.
create_taskAdd a follow-up task, linked to a contact, company, or deal.
complete_taskMark a task done.
add_noteRecord a note on a contact, company, or deal.
log_callRecord 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.

PromptWhat it does
log_call_and_follow_upLog a call, then create its follow-up tasks.
weekly_pipeline_reviewList open deals by stage and flag deals with no activity in 14 days.
add_contact_from_signatureTurn an email signature or business card text into a contact.
import_csvImport a CSV file after you check the column mapping.
prepare_for_meetingGet 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
  1. Open the HonestCRM listing, or in Claude open Settings > Connectors, choose Browse connectors, and search for HonestCRM.
  2. Choose Connect.
  3. Sign in to honestcrm if you are not signed in.
  4. 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/mcp

Claude custom connector

  1. Open Settings > Connectors and choose Add custom connector.
  2. Paste the URL above and save.
  3. Choose Connect, and sign in to honestcrm if you are not signed in.
  4. Review the request and choose Allow.

ChatGPT

  1. Turn on developer mode in the ChatGPT connector settings.
  2. Add a connector, paste the URL above, and choose OAuth for authentication.
  3. 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

  1. In honestcrm, open Settings > Agents and create an agent. Give it a name, such as Claude Code.
  2. Copy the key, which starts with hca_. honestcrm shows it once.
  3. Add the server to your client with one of the snippets below, and replace hca_your_key with 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.

MCP server questions

What is the honestcrm MCP server?

It is an endpoint that lets an AI agent, such as Claude, ChatGPT, Claude Code, or Cursor, read and change your honestcrm data. It uses the Model Context Protocol (MCP), an open standard that AI tools use to connect to other software.

What can an AI agent do in my CRM through MCP?

An agent can search your records, read contacts, companies, deals, and tasks, create and update records, move a deal to another open stage, add notes, log calls, and complete tasks. That is 18 tools: seven that read and eleven that write.

Which plans include agent access?

Agent access is on the Free and Pro plans. Changes an agent makes count against the same plan limits as changes you make in the console.

Does agent use count as AI requests?

No. honestcrm runs no model for agent access. The agent you connect does the thinking and honestcrm does the reading and writing.

Can an agent see more than I can?

No. An agent has your current role, permissions, and record visibility. If an admin changes your role, your agents change with it.

How do I connect Claude or ChatGPT?

In Claude, add HonestCRM from the Claude connectors directory, or add the honestcrm endpoint as a custom connector. In ChatGPT, add the endpoint as a connector in developer mode. Sign in to honestcrm when the app asks, review the request, and choose Allow. You do not copy a key.

How do I stop an agent?

Revoke the agent in Settings > Agents. It stops working immediately, whether it connected with OAuth or with a key.

Start for free with your whole team

Unlimited users. No card required. No sales call.

Start for free