Close MCP server

OfficialCloseConfig last verified Jun 1, 2026

Close's official remote MCP server connects AI agents to the Close sales CRM over OAuth to read, create, and update leads, contacts, and deals.

Close MCP is the official hosted server from Close, the CRM built for high-velocity sales teams. It connects any MCP-compatible AI client to a Close organization over OAuth and exposes the CRM end to end: search leads and contacts (including a natural-language search tool), fetch and create leads, contacts, opportunities, notes, tasks, addresses, pipelines, and statuses, run activity searches and aggregations for reporting, and manage email and SMS templates, smart views, workflows, and even voice agents. An agent can answer pipeline questions, log activity after a call, or draft and schedule follow-ups without a rep leaving the conversation.

The canonical deployment is the remote endpoint at https://mcp.close.com/mcp over Streamable HTTP, authenticated with OAuth 2.0 using Dynamic Client Registration so supported clients like Claude, ChatGPT, and Cursor connect with one flow and no long-lived key. Which tools are available is governed by a Close-Scope header: mcp.read is read-only, mcp.write_safe permits reads and non-destructive writes, and mcp.write_destructive additionally allows delete operations. Because the destructive scope can permanently remove leads, contacts, and other records, grant it deliberately and keep mutating actions behind review.

Quick install

Copy-paste configs are provided for all 8 supported clients. Pick your client below.

Add to ~/.claude.json

~/.claude.json
json
{
  "mcpServers": {
    "close": {
      "type": "http",
      "url": "https://mcp.close.com/mcp"
    }
  }
}
Or via CLI
bash
claude mcp add --transport http close https://mcp.close.com/mcp

Heads up

  • First tool call opens a browser to authorize.

Available tools

ToolDescription
searchPerforms a natural-language search for leads or contacts.
lead_searchPerforms a structured lead search with filters and pagination.
activity_searchSearches activities, returned ordered by date descending.
paginate_searchPaginates an existing search using a cursor.
aggregationRuns aggregations to answer questions about activity metrics.
get_fieldsGets the field list available for use with the aggregation tool.
find_reporting_metricsFinds the available predefined reporting metrics.
org_infoReturns general organization and user information.
org_usersReturns the active users (memberships) in the organization.
close_product_knowledge_searchSearches Close documentation for feature and integration guidance.
fetchRetrieves the contents of an arbitrary object by its ID.
fetch_leadFetches an existing lead (company) by ID.
fetch_contactRetrieves a contact's details including name, title, emails, and phones.
fetch_opportunityRetrieves a complete opportunity with all details.
fetch_noteRetrieves a note's details including title, text, and metadata.
fetch_taskRetrieves a task's details including assignee, due date, and status.
fetch_lead_statusFetches a lead status by ID.
fetch_opportunity_statusFetches an opportunity status by ID.
fetch_pipeline_and_opportunity_statusesRetrieves a pipeline with its opportunity statuses.
fetch_lead_smart_viewRetrieves a saved lead search (smart view) by ID.
fetch_email_templateRetrieves a complete email template with all details.
fetch_sms_templateRetrieves a complete SMS template with all details.
find_notesFinds notes based on various filters.
find_tasksFinds tasks filtered by lead, assignee, completion, and dates.
find_opportunitiesFinds opportunities filtered by lead, user, status, and dates.
find_lead_statusesLists or finds lead statuses for the organization.
find_pipelines_and_opportunity_statusesLists all opportunity pipelines and their statuses.
find_lead_smart_viewsLists lead smart views (saved searches).
find_lead_custom_fieldsLists lead custom fields with IDs, types, and choices.
find_custom_activitiesLists all active (non-archived) custom activity types.
find_email_templatesLists or finds email templates.
find_sms_templatesLists or finds SMS templates.
find_workflowsLists or finds workflows.
find_formsLists all web forms in the organization.
find_groupsLists all groups in the organization.
find_scheduling_linksLists available scheduling links for the user and organization.
find_call_outcomesLists all call outcome options in the organization.
find_meeting_outcomesLists all meeting outcome options available.
find_voice_agentsLists all voice agents configured for the organization.
get_voice_agentsReturns detailed voice agent configuration.
create_leadCreates a new lead (company).
create_contactCreates a new contact for a lead.
create_addressAdds a new address to an existing lead.
create_opportunityCreates a new opportunity, requiring lead and status IDs.
create_noteCreates a text-based activity note attached to a lead.
create_taskCreates a new to-do task for a lead.
create_lead_statusCreates a new lead status.
create_opportunity_status_toolCreates a new opportunity status.
create_pipelineCreates a new opportunity pipeline.
create_email_templateCreates a new email template with an HTML body.
create_sms_templateCreates a new SMS template.
create_workflowCreates a new workflow (sequence) in Draft status.
update_leadUpdates fields on an existing lead.
update_contactUpdates a contact's name, title, emails, phones, and URLs.
update_opportunityUpdates fields on an existing opportunity.
update_taskUpdates fields on an existing task.
update_lead_statusUpdates the label of an existing lead status.
update_opportunity_status_toolUpdates the label of an existing opportunity status.
update_pipelineUpdates an existing opportunity pipeline.
update_lead_smart_viewUpdates a lead smart view (saved search).
update_email_templateUpdates fields on an existing email template.
update_sms_templateUpdates fields on an existing SMS template.
schedule_voice_agent_callSchedules a voice agent to call a lead's contact.
propose_voice_agent_updateProposes a voice agent configuration update.
apply_voice_agent_updateApplies a previously proposed voice agent update.
delete_leadPermanently deletes an existing lead (company) by ID.
delete_contactPermanently deletes an existing contact.
delete_notePermanently deletes an existing note.
delete_taskPermanently deletes an existing task by ID.
delete_opportunityPermanently deletes an opportunity.
delete_addressDeletes an address from an existing lead.
delete_lead_statusPermanently deletes a lead status.
delete_opportunity_status_toolPermanently deletes an opportunity status.
delete_pipelinePermanently deletes an opportunity pipeline.
delete_lead_smart_viewPermanently deletes a lead smart view.
delete_email_templatePermanently deletes an email template.
delete_sms_templatePermanently deletes an SMS template.

What you can do with it

Answer pipeline questions

An agent runs lead and activity searches and aggregations to report on pipeline status, win rates, or a specific account's history without a rep opening the CRM.

Log and follow up after a call

The agent creates a note, updates the opportunity status, and schedules a task or follow-up so Close reflects the latest state of the deal immediately.

FAQ

Is it free?
The MCP server is free to connect; it works within your existing Close plan and its API limits, and you pay only for Close itself.
Does it support remote/OAuth?
Yes. The canonical deployment is the remote endpoint at https://mcp.close.com/mcp over Streamable HTTP, authenticated with OAuth 2.0 using Dynamic Client Registration, so supported clients connect with no long-lived key.
How do I control what it can change?
A Close-Scope header sets the permission level: mcp.read is read-only, mcp.write_safe allows non-destructive writes, and mcp.write_destructive additionally allows deletes. Grant the destructive scope deliberately and keep mutating actions behind review.
← Browse all crm servers