electrical_services

Freshsales MCP Server — Hosted Api Connectors Integration

MCP Server language Hosted language Public

Manage contacts, leads, deals, and accounts in Freshsales CRM with search and note capabilities.

@aerostack verified

• v0.1.0 • MIT • Updated Jun 28, 2026

add_circleAdd to Workspace

robot_2

Use with AI AssistantsMCP

Connect Claude, Cursor, or any MCP-compatible client — then call tools directly

① Add This MCP Server

Paste into your AI client config — then all its tools are available instantly.

.claude/mcp.json

{
  "mcpServers": {
    "freshsales": {
      "url": "https://mcp.aerostack.dev/s/aerostack/mcp-freshsales",
      "headers": {
        "Authorization": "Bearer YOUR_AEROSTACK_TOKEN"
      }
    }
  }
}

Replace YOUR_AEROSTACK_TOKEN with your API token from the dashboard.

② Call a Tool

Ask your AI assistant to call a specific tool, or send raw JSON-RPC:

+13 more

Natural Language Prompt

“Use the _ping tool to verify freshsales credentials by calling a lightweight read endpoint. used internally by aerostack to validate credentials”

Using a Workspace?

Add this MCP to your Workspace — your team shares one token, secrets are stored securely, and every AI agent in the workspace can call it without per-user setup.

add_circleAdd to Workspace

description Overview

mcp-freshsales — Freshsales MCP Server

Manage contacts, leads, deals, and accounts in Freshsales CRM with search and note capabilities.

Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-freshsales

What You Can Do

This MCP server gives AI agents access to Freshsales via 18 tools. Connect it to any Aerostack workspace and your agents can interact with Freshsales directly.

Available Tools

Tool	Description
`list_contacts`	List contacts in Freshsales
`create_contact`	Create a new contact in Freshsales
`get_contact`	Get a specific contact by ID
`update_contact`	Update a contact in Freshsales
`delete_contact`	Delete a contact from Freshsales
`list_leads`	List leads in Freshsales
`create_lead`	Create a new lead in Freshsales
`get_lead`	Get a specific lead by ID
`convert_lead`	Convert a lead to contact, account, and deal
`list_deals`	List deals in Freshsales
`create_deal`	Create a new deal in Freshsales
`get_deal`	Get a specific deal by ID
`update_deal`	Update a deal in Freshsales
`list_accounts`	List accounts (sales accounts) in Freshsales
`create_account`	Create a new account in Freshsales
`create_note`	Create a note attached to a CRM record
`list_notes`	List notes for a CRM record
`search`	Search across Freshsales records

Configuration

Variable	Required	Description
`FRESHSALES_API_KEY`	Yes	Your FRESHSALES API KEY from the service's developer settings
`FRESHSALES_DOMAIN`	Yes	See provider documentation

Quick Start

Add to Aerostack Workspace

Go to aerostack.dev → Your Project → MCPs
Search for "Freshsales" and click Add to Workspace

Add the following secrets under Project → Secrets:

FRESHSALES_API_KEY
FRESHSALES_DOMAIN

Once added, every AI agent in your workspace can use Freshsales tools automatically.

Direct API Call

curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-freshsales \
  -H 'Content-Type: application/json' \
  -H 'X-Mcp-Secret-FRESHSALES-API-KEY: your-freshsales-api-key' \
  -H 'X-Mcp-Secret-FRESHSALES-DOMAIN: your-freshsales-domain' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_contacts","arguments":{}}}'

License

MIT

terminal Tools (19)

Available tools on this MCP server. Each tool can be called directly from any AI agent.

terminal

_ping #1

Verify Freshsales credentials by calling a lightweight read endpoint. Used internally by Aerostack to validate credentials.

terminal

list_contacts #2

List contacts in Freshsales

terminal

create_contact #3

Create a new contact in Freshsales

terminal

get_contact #4

Get a specific contact by ID

terminal

update_contact #5

Update a contact in Freshsales

terminal

delete_contact #6

Delete a contact from Freshsales

terminal

list_leads #7

List leads in Freshsales

terminal

create_lead #8

Create a new lead in Freshsales

terminal

get_lead #9

Get a specific lead by ID

terminal

convert_lead #10

Convert a lead to contact, account, and deal

terminal

list_deals #11

List deals in Freshsales

terminal

create_deal #12

Create a new deal in Freshsales

terminal

get_deal #13

Get a specific deal by ID

terminal

update_deal #14

Update a deal in Freshsales

terminal

list_accounts #15

List accounts (sales accounts) in Freshsales

terminal

create_account #16

Create a new account in Freshsales

terminal

create_note #17

Create a note attached to a CRM record

terminal

list_notes #18

List notes for a CRM record

terminal

search #19

Search across Freshsales records

Details

upgrade Version 0.1.0

gavel License MIT

wifi Transport streamable-http

lock Access Public

category Category API Connectors

terminal Tools 19

language Live Endpoint

https://mcp.aerostack.dev/s/aerostack/mcp-freshsales

Sub-50ms globally · Zero cold start

Publisher

@aerostack verified

Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.

Frequently asked questions

What is the Freshsales MCP server and what can it do? +

The Freshsales MCP server is hosted on Aerostack and exposes these tools to your AI agent: `_ping`, `list_contacts`, `create_contact`, `get_contact`, `update_contact`. You get one hosted URL — no self-hosting — that works from Claude, Cursor, ChatGPT, Gemini, VS Code, or any MCP-compatible client, and you can share it with your team or combine it with other MCP servers in a workspace.

Is the Freshsales MCP server hosted, or do I have to run it myself? +

It's hosted on Aerostack's edge infrastructure — you don't deploy or maintain anything. Add it to a workspace and you get one authenticated URL, with secrets encrypted, that any AI agent or editor can connect to. Use it solo or share the same URL across your whole team.

Which AI agents and editors can use the Freshsales MCP server? +

Any MCP client: Claude and Claude Code, Cursor, ChatGPT, Gemini, Windsurf, Cline, VS Code, and custom agents. Because it's one hosted URL, the same Freshsales MCP server works everywhere — and you can compose it with other MCP servers, skills, and functions behind a single workspace URL.

How do I install the Freshsales MCP server in Claude Desktop? +

Add the following to your Claude Desktop config (`claude_desktop_config.json`): ```json { "mcpServers": { "@aerostack/mcp-freshsales": { "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-freshsales"] } } } ``` Then restart Claude Desktop and the tools will appear automatically.

How do I use the Freshsales MCP server in Cursor? +

In Cursor, open **Settings → MCP** and add: ```json { "name": "@aerostack/mcp-freshsales", "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-freshsales"] } ``` Save and reload Cursor. The MCP tools will be available in Agent mode.

Does Freshsales MCP require authentication? +

Yes. Freshsales requires authentication. Check the MCP's documentation for the required credentials.

Freshsales MCP Server — Hosted Api Connectors Integration

description Overview

mcp-freshsales — Freshsales MCP Server

What You Can Do

Available Tools

Configuration

Quick Start

Add to Aerostack Workspace

Direct API Call

License

terminal Tools (19)

Details

Publisher

Tags

More in API Connectors

Aerostack Registry

Algolia

Arangodb

Ayrshare

Basecamp

Bigquery

Frequently asked questions