MCP server

Freshsales MCP by usefulapi

io.usefulapi/freshsales

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Manage Freshsales contacts, accounts, deals, tasks and appointments; add notes.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

31

Token cost

About 9,284 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http freshsales https://freshsales.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.freshsales]
url = "https://freshsales.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"freshsales":{"httpUrl":"https://freshsales.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"freshsales":{"url":"https://freshsales.usefulapi.io/mcp"}}}

VS Code

{"servers":{"freshsales":{"type":"http","url":"https://freshsales.usefulapi.io/mcp"}}}

Antigravity

agy mcp add freshsales https://freshsales.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"freshsales","server_url":"https://freshsales.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"freshsales","server_url":"https://freshsales.usefulapi.io/mcp"}

Tools

• freshsales_create_account Changes accounts · ~628 tokens
  WRITE: create an account (company). name is required. It may duplicate an existing company: search first (freshsales_search). POST /sales_accounts.
• freshsales_create_appointment ~662 tokens
  WRITE: create an appointment (meeting) with a start and end, optionally attached to a contact, account or deal and with attendees. Attendees may be notified by Freshsales. POST /appointments.
• freshsales_create_contact ~745 tokens
  WRITE: create a contact. Freshsales requires an email or a mobile number. It may create a duplicate of an existing contact: search first (freshsales_lookup by email). POST /contacts.
• freshsales_create_deal ~648 tokens
  WRITE: create a deal. name, amount and sales_account_id are required; contact_ids attach existing contacts. Stage and pipeline default to the first of the default pipeline. POST /deals.
• freshsales_create_note ~198 tokens
  WRITE: add a note to a contact, account or deal. Visible to your team on the record. POST /notes.
• freshsales_create_task ~407 tokens
  WRITE: create a task (to-do) attached to a contact, account or deal. title, due_date, owner_id and the target are required. POST /tasks.
• freshsales_get_account ~206 tokens
  One account (company) by id with its fields, optionally with related records embedded (contacts, deals, tasks, appointments, owner...). GET /sales_accounts/{id}.
• freshsales_get_appointment ~106 tokens
  One appointment by id with its attendees. GET /appointments/{id}.
• freshsales_get_contact ~210 tokens
  One contact by id with all its fields, optionally with related records embedded via include (notes, tasks, appointments, deals, sales_accounts, owner, sales_activities...). GET /contacts/{id}.
• freshsales_get_deal ~231 tokens
  One deal by id with amount, expected close, probability and ids of its stage, pipeline and owner, optionally with related records embedded (contacts, sales_account, deal_stage, owner, notes via sales_activities...). GET /deals/{id}.
• freshsales_get_task ~89 tokens
  One task by id. GET /tasks/{id}.
• freshsales_list_account_views ~90 tokens
  List the saved account (company) views of the account, e.g. 'My Accounts'. A view id is needed by freshsales_list_accounts. GET /sales_accounts/filters.
• freshsales_list_accounts ~252 tokens
  List the accounts (companies) in a view (view_id from freshsales_list_account_views), 25 per page, with name, location, open deals amount and last contacted. GET /sales_accounts/view/{view_id}.
• freshsales_list_appointments ~154 tokens
  List appointments that are open (upcoming) or complete (one filter per call), with title, time, location and creator. GET /appointments.
• freshsales_list_contact_views ~105 tokens
  List the saved contact views (filters) of the account, e.g. 'My Contacts', 'New Contacts', 'All Contacts'. A view id is needed by freshsales_list_contacts; ids differ per account. GET /contacts/filters.
• freshsales_list_contacts ~268 tokens
  List the contacts in a view (get view_id from freshsales_list_contact_views), 25 per page with name, email, phone numbers, job title, lead score, open deals amount and last contacted. Pages: use next_page. GET /contacts/view/{view_id}.
• freshsales_list_deal_pipelines ~66 tokens
  List the deal pipelines (id, name). GET /selector/deal_pipelines.
• freshsales_list_deal_stages ~158 tokens
  List deal stages (id, name, deal_pipeline_id): those of the default pipeline, or of the pipeline given by pipeline_id. Use the id as deal_stage_id. GET /selector/deal_stages or /selector/deal_pipelines/{id}/deal_stages.
• freshsales_list_deal_views ~82 tokens
  List the saved deal views of the account, e.g. 'Open Deals'. A view id is needed by freshsales_list_deals. GET /deals/filters.
• freshsales_list_deals ~243 tokens
  List the deals in a view (view_id from freshsales_list_deal_views), 25 per page, with name, amount, expected close, probability and age. GET /deals/view/{view_id}.
• freshsales_list_options ~243 tokens
  List the configured choices (id and name) for a field: lead_sources, contact_statuses, lifecycle_stages, deal_types, deal_reasons, deal_products, deal_payment_statuses, territories, currencies, industry_types, business_types, campaigns, sales_activity_types, sales_activity_outcomes. Use the ids in t
• freshsales_list_owners ~80 tokens
  List the users of the account (id and name). Use the id as owner_id when creating or updating records. GET /selector/owners.
• freshsales_list_sales_activities ~143 tokens
  List logged sales activities (calls, meetings, emails...) of the account. GET /sales_activities.
• freshsales_list_tasks ~167 tokens
  List tasks by status filter: open, due_today, due_tomorrow, overdue or completed (one filter per call). Returns title, due date, owner and status. GET /tasks.
• freshsales_lookup ~217 tokens
  Exact-match lookup of contacts, companies or deals by one field, e.g. a contact by email address. field is 'email' (contacts), 'name', or a custom field name (cf_...). Returns the full records. GET /lookup.
• freshsales_search ~217 tokens
  Search by name/email text across one record type: contact, sales_account (company), deal or user. Returns id, type, name and email for the matches (up to per_page, default 10). Use the id with the get tools. GET /search.
• freshsales_update_account ~656 tokens
  WRITE: change fields of an existing account (company); only the fields you pass are changed. PUT /sales_accounts/{id}.
• freshsales_update_contact ~777 tokens
  WRITE: change fields of an existing contact; only the fields you pass are changed (passing sales_accounts replaces the associated companies). PUT /contacts/{id}.
• freshsales_update_deal ~751 tokens
  WRITE: change fields of an existing deal, e.g. move it to another stage (deal_stage_id), change amount or expected close; only the fields you pass are changed. PUT /deals/{id}.
• freshsales_update_note ~130 tokens
  WRITE: replace the text of an existing note. PUT /notes/{id}.
• freshsales_update_task ~355 tokens
  WRITE: change a task: title, details, due date, owner, or mark it completed (status 1) or open (status 0). PUT /tasks/{id}.

Browse

• Email
• Booking and scheduling

Related MCP servers

• JobNimbus MCP by usefulapi
  Manage JobNimbus contacts, jobs, tasks, estimates and invoices from chat.
• Teamgate MCP by usefulapi
  Manage Teamgate CRM leads, people, companies, deals, activities and notes.
• Pipeline CRM MCP by usefulapi
  Manage Pipeline CRM deals, people, companies, notes and calendar entries.
• Propstack MCP by usefulapi
  Read Propstack contacts, properties, projects, deals, tasks, events; create and update CRM records.
• Cogmento MCP by usefulapi
  Read Cogmento CRM contacts, companies, deals, tasks and cases; create records and complete tasks.
• CentralStationCRM MCP by usefulapi
  Read CentralStationCRM people, companies, deals, tasks; create and update people, companies, deals.
• Teamleader Focus MCP by usefulapi
  Read Teamleader Focus contacts, companies, deals, invoices, projects; create deals, tasks.
• Follow Up Boss MCP by usefulapi
  Search Follow Up Boss leads, review calls and deals, and add notes, tasks and deal updates.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/freshsales.svg)](https://aptlynx.net/servers/io.usefulapi/freshsales)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents