# Freshsales MCP by usefulapi

> Freshsales MCP by usefulapi is a freemium MCP server for sales and crm. Hosted MCP server connecting Freshsales CRM contacts, deals and tasks to AI assistants. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web
- **Website:** https://usefulapi.io/freshsales/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/freshsales
- **MCP Registry name:** io.usefulapi/freshsales
- **Categories:** sales and CRM
- **Listing updated:** 2026-11-18

## About

The README describes a hosted endpoint that lets Claude, ChatGPT, Cursor and other MCP clients read and edit a Freshsales account. Setup is done through a login page where you enter your Freshsales domain and API key, so nothing is placed in client config files.

The server exposes 36 Freshsales operations plus usage and subscription helpers. Read tools cover contact, lead, account and deal views, tasks, appointments, pipelines and option lists. Twelve write tools can create or update contacts, accounts, deals, notes, tasks and appointments, and one can delete a contact after a confirmation step.

It suits sales teams that already run Freshsales and want to query pipeline status or log follow-ups through a chat assistant. Freshsales limits API calls to 1,000 per hour per account, and the server's free tier caps usage at 50 tool calls a month.

## Features

- **Hosted remote endpoint:** Runs as a Streamable HTTP server, so no local install is needed.
- **OAuth login with API key:** Users enter their Freshsales domain and API key on a login page rather than in client config.
- **Contact, account and deal reads:** Lists views, searches records and fetches deals with amount, close date and probability.
- **Guarded write operations:** Twelve tools create or change records, and contact deletion requires an explicit confirmation.
- **Tasks and appointments:** Lists overdue or upcoming tasks and appointments and can create or complete them.

## Good for

- Ask an assistant which open deals close this month and what stage they are in
- Log a call note or follow-up task on a contact after a meeting
- Look up a contact by email and review their notes and open tasks
- Create a company and deal in Freshsales from a conversation
- Export all contacts from a saved view as a backup

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://freshsales.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "freshsales": {
      "serverUrl": "https://freshsales.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "freshsales": {
      "type": "http",
      "url": "https://freshsales.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `freshsales_list_contacts`: List the contacts in a view, 25 per page.
- `freshsales_get_contact`: Get one contact by id with optional related records.
- `freshsales_search`: Search contacts, leads, companies or deals by name or email.
- `freshsales_lookup`: Exact-match lookup of records by one field such as email.
- `freshsales_list_deals`: List the deals in a view with amount, expected close and probability.
- `freshsales_get_deal`: Get one deal by id with stage, pipeline and owner ids.
- `freshsales_list_tasks`: List tasks by status filter such as open or overdue.
- `freshsales_list_appointments`: List upcoming or completed appointments.
- `freshsales_create_contact`: Create a contact after checking for duplicates.
- `freshsales_create_deal`: Create a deal with name, amount and company.
- `freshsales_update_deal`: Change a deal's stage, amount or expected close date.
- `freshsales_create_note`: Add a note to a contact, company or deal.
- `freshsales_create_task`: Create a task attached to a contact, company or deal.
- `freshsales_create_appointment`: Create an appointment with start, end and attendees.
- `freshsales_delete_contact`: Delete one contact after a preview and confirmation step.
- `freshsales_usage_status`: Report current plan usage and remaining calls.
- `freshsales_upgrade`: Start a Pro or Pro+ subscription via Stripe Checkout.
- `freshsales_cancel_subscription`: Cancel the Pro subscription at the end of the paid period.

## FAQ

### Is this an official Freshsales product?

No. The README and site state that usefulapi is an independent service not affiliated with or endorsed by Freshsales.

### How are Freshsales credentials handled?

The site says the login stores them encrypted in the authorization grant of the connection and that they are not shown on any page or in any reply.

### Can the AI change data in Freshsales?

Yes. Twelve of the 36 Freshsales tools can create or change data, and the other 24 are read-only.

### What does the free plan include?

The free plan allows 50 tool calls per month. Paid Pro is $9 per month or $90 per year for 10,000 calls, and Pro+ is $39 per month or $390 per year for 100,000 calls.

### Is Freshsales MCP by usefulapi free?

Freshsales MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Freshsales MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http freshsales https://freshsales.usefulapi.io/mcp

### What are the best alternatives to Freshsales MCP by usefulapi?

The closest alternatives to Freshsales MCP by usefulapi are Calven, CompanyData, MisarReach MCP Server, NeuralVerge and ZUUZ.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [ZUUZ](https://ai-powered.com/mcp/zuuz): ZUUZ is an MCP server for sales and crm.
- [Fuse](https://ai-powered.com/mcp/fuse-2): Fuse is a freemium MCP server for sales and crm.
- [Gender-API.com](https://ai-powered.com/mcp/gender-api-com): Gender-API.com is a freemium MCP server for analytics and data.
- [Dialvett: Bulk Phone Number Validator & Carrier Lookup](https://ai-powered.com/mcp/dialvett-bulk-phone-number-validator-and-carrier-lookup): Dialvett: Bulk Phone Number Validator & Carrier Lookup is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/freshsales-mcp-by-usefulapi
