How to Use the Freshsales MCP in Claude Code

Q: How do I add the Freshsales MCP Server to Claude Code?

Run the command claude mcp add --transport http freshsales -- in your terminal. Make sure all flags come before the server name, then verify with claude mcp list.

Q: Can I use Claude Code to bulk export Freshsales contacts?

Yes. You can ask Claude Code to run listcontacts and pipe the JSON output directly into a local CSV file. It is the fastest way to get raw data into your terminal.

Q: How does the terminal agent handle complex CRM searches?

It uses listsalesaccounts and listleads to fetch the raw records, then applies local terminal filters like awk or grep to find exactly what you need.

Run terminal commands to manage Freshsales leads and pipeline deals directly from your shell with Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Freshsales MCP to Claude Code

Create your Vinkius account to connect Freshsales to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Freshsales with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pipe Freshsales CRM data directly to terminal tools

Run `list_deals` to bring your sales data straight to your command line. You can pull your active pipeline and pipe the output to grep or jq to filter down to high-value opportunities. No more clicking through slow web interfaces. This terminal-focused MCP Server lets you script quick updates or run batch commands using `list_leads` to get instant visibility into your sales funnel.

Script automated lead creation with this Claude Code MCP Server

Execute `create_lead` to speed up your outbound workflows directly from your shell. The CLI agent handles the rest, verifying details with `get_lead` to ensure the write succeeded. You can easily hook this up to local bash scripts or cron jobs. It is built for developers who want to manage their sales pipeline with the same speed they manage their git repositories.

Manage sales tasks and meetings from the command line

Use `list_appointments` to pull your daily agenda without opening a browser. Use Claude Code to check off pending tasks via `list_tasks` and keep your schedule clean. The agent can read your local notes, extract action items, and log them to CRM records using `list_notes`. It keeps your workspace clean and your CRM updated directly from your terminal session.

Setup guide

Set up Freshsales MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see freshsales-alternative-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Freshsales transactions." It will automatically discover and invoke the available Freshsales tools.

Terminal

claude mcp add --transport http freshsales-alternative-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Freshsales MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "freshsales-alternative-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Freshsales. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Freshsales now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Freshsales MCP in Claude Code

Run the command `claude mcp add --transport http freshsales -- ` in your terminal. Make sure all flags come before the server name, then verify with `claude mcp list`.

Yes. You can ask Claude Code to run `list_contacts` and pipe the JSON output directly into a local CSV file. It is the fastest way to get raw data into your terminal.

No, it requires an active connection. However, you can write bash scripts that trigger Claude Code to run `list_deals` or `list_tasks` as part of your local cron jobs.

It uses `list_sales_accounts` and `list_leads` to fetch the raw records, then applies local terminal filters like awk or grep to find exactly what you need.

Your credentials are secure. Vinkius handles the authorization via a single endpoint token, meaning Claude Code never touches your raw CRM password or API key.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript