Freshdesk MCP Server — Hosted Customer Support Integration
MCP Server language Hosted language PublicCreate tickets, manage contacts, and resolve support issues faster — give your AI agents full Freshdesk access.
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.
{
"mcpServers": {
"freshdesk": {
"url": "https://mcp.aerostack.dev/s/aerostack/mcp-freshdesk",
"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:
Natural Language Prompt
“Use the _ping tool to verify freshdesk 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.
description Overview
mcp-freshdesk — Freshdesk MCP Server
Supercharge your customer support operations — let AI agents triage tickets, manage contacts, reply to customers, and report on team performance.
Freshdesk is a leading cloud-based customer support platform used by over 60,000 businesses. This MCP server gives your agents complete access to Freshdesk's support infrastructure: creating and triaging tickets, managing contacts and companies, posting replies and internal notes, and pulling performance statistics — enabling fully automated support workflows.
Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-freshdesk
What You Can Do
- Automatically triage and route incoming support tickets based on content, priority, or customer tier
- Create support tickets from any trigger — form submissions, emails, Slack messages, or payment failures
- Reply to tickets or add internal notes without leaving your AI workflow
- Pull ticket statistics and agent workloads for real-time support dashboards
Available Tools
| Tool | Description |
|---|---|
| list_tickets | List tickets with optional filters for status, priority, and assignee |
| get_ticket | Get full details of a specific ticket including description and metadata |
| create_ticket | Create a new support ticket with subject, description, priority, and type |
| update_ticket | Update ticket fields — status, priority, assignee, tags, and more |
| delete_ticket | Permanently delete a ticket by ID |
| list_ticket_conversations | List all replies and notes on a ticket |
| add_reply | Post a reply to a ticket visible to the requester |
| add_note | Add an internal note to a ticket visible only to agents |
| update_ticket_status | Convenience tool to change a ticket's status (open, pending, resolved, closed) |
| list_contacts | List contacts with optional filters |
| get_contact | Get full details of a specific contact |
| create_contact | Create a new contact with name, email, phone, and company |
| update_contact | Update contact details |
| search_contacts | Search contacts by email, name, or phone |
| merge_contacts | Merge duplicate contacts into a primary contact |
| list_companies | List all companies in Freshdesk |
| get_company | Get details of a specific company |
| create_company | Create a new company with name, domains, and description |
| list_company_contacts | List all contacts associated with a company |
| list_agents | List all support agents in your Freshdesk account |
| get_agent | Get details of a specific agent |
| get_current_agent | Get the profile of the currently authenticated agent |
| list_groups | List all agent groups in your Freshdesk account |
| get_group | Get details of a specific agent group |
| get_ticket_stats | Get ticket statistics — counts by status, priority, and agent |
Configuration
| Variable | Required | Description | How to Get |
|---|---|---|---|
| FRESHDESK_API_KEY | Yes | Freshdesk API key | Freshdesk → Profile icon → Profile Settings → API Key |
| FRESHDESK_DOMAIN | Yes | Your Freshdesk subdomain (e.g. acme for acme.freshdesk.com) |
Your Freshdesk URL |
Quick Start
Add to Aerostack Workspace
- Go to aerostack.dev → Your Project → MCPs
- Search for "Freshdesk" and click Add to Workspace
- Add your
FRESHDESK_API_KEYandFRESHDESK_DOMAINunder Project → Secrets
Once added, every AI agent in your workspace can manage Freshdesk support tickets automatically — no per-user setup needed.
Example Prompts
"Create a high-priority ticket for customer john@acme.com — their payment integration is down"
"List all open tickets assigned to agent ID 5 and summarize their status"
"Reply to ticket #1042 saying we've identified the issue and will have a fix within 2 hours"
Direct API Call
curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-freshdesk \
-H 'Content-Type: application/json' \
-H 'X-Mcp-Secret-FRESHDESK-API-KEY: your-key' \
-H 'X-Mcp-Secret-FRESHDESK-DOMAIN: acme' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_tickets","arguments":{"status":"open"}}}'
License
MIT
terminal Tools (26)
Available tools on this MCP server. Each tool can be called directly from any AI agent.
_ping #1 Verify Freshdesk credentials by calling a lightweight read endpoint. Used internally by Aerostack to validate credentials.
list_tickets #2 List tickets from Freshdesk with optional filters. Returns tickets sorted by creation date descending. Use filter to target named views like "new_and_my_open", "watching", "spam", "deleted".
get_ticket #3 Get full details of a specific ticket by ID — subject, description, status, priority, tags, requester, assignee, timestamps.
create_ticket #4 Create a new Freshdesk support ticket. Status: 2=open, 3=pending, 4=resolved, 5=closed. Priority: 1=low, 2=medium, 3=high, 4=urgent.
update_ticket #5 Update an existing ticket — change priority, status, subject, description, tags, type, or assignment.
delete_ticket #6 Delete a ticket permanently. This action cannot be undone — the ticket is moved to trash first. Returns success confirmation.
list_ticket_conversations #7 List all conversations (replies and notes) on a ticket — public replies and private agent notes.
add_reply #8 Add a public reply to a ticket that is visible to the requester. Supports CC and BCC addresses.
add_note #9 Add a private internal note to a ticket, visible only to agents. Optionally notify specific agents via email.
update_ticket_status #10 Convenience tool — update only the status of a ticket. Status: 2=open, 3=pending, 4=resolved, 5=closed.
list_contacts #11 List contacts (customers) with optional filters by email, mobile, or phone. Supports pagination.
get_contact #12 Get full details of a specific contact by ID — name, email, phone, company, tags, description.
create_contact #13 Create a new contact in Freshdesk. Name is required. Optionally associate with a company.
update_contact #14 Update contact details — name, email, phone, mobile, company, tags, or description.
search_contacts #15 Search contacts by name, email, phone, or other fields using a query string.
merge_contacts #16 Merge a contact into another (target). The source contact is deleted; all tickets are transferred to the target.
list_companies #17 List all companies registered in Freshdesk. Supports pagination.
get_company #18 Get full details of a specific company by ID — name, description, domains, notes.
create_company #19 Create a new company in Freshdesk. Name is required.
list_company_contacts #20 List all contacts (customers) belonging to a specific company.
list_agents #21 List all agents (support staff) in the Freshdesk account — name, email, type, groups, availability status.
get_agent #22 Get details of a specific agent by ID — name, email, type, ticket scope, groups, availability.
get_current_agent #23 Get the details of the currently authenticated agent (based on the API key being used). Useful to identify yourself.
list_groups #24 List all support groups (teams) in Freshdesk — name, description, escalation settings.
get_group #25 Get details of a specific group (team) by ID — name, description, escalation agent, unassigned timeout.
get_ticket_stats #26 Get overview ticket statistics — open, pending, resolved, overdue counts. Requires Freshdesk Freddy Analytics or higher plan. Returns fallback summary from ticket filter counts if the reports endpoint is unavailable.
Details
language Live Endpoint
https://mcp.aerostack.dev/s/aerostack/mcp-freshdesk
Sub-50ms globally · Zero cold start
Publisher
Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.
More in Customer Support
Browse Customer Support MCPs →Salesforce
by @aerostack
Query leads, contacts, opportunities, and accounts in Salesforce — full SOQL support for enterprise CRM automation.
Zendesk
by @aerostack
Manage support tickets, users, and knowledge base articles in Zendesk — AI-powered customer service automation.
Zoho Crm
by @aerostack
Manage leads, contacts, deals, accounts, and tasks in Zoho CRM with full CRUD operations and lead conversion.
Frequently asked questions
What is the Freshdesk MCP server and what can it do? +
The Freshdesk MCP server is hosted on Aerostack and exposes these tools to your AI agent: `_ping`, `list_tickets`, `get_ticket`, `create_ticket`, `update_ticket`. 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 Freshdesk 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 Freshdesk 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 Freshdesk 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 Freshdesk MCP server in Claude Desktop? +
Add the following to your Claude Desktop config (`claude_desktop_config.json`): ```json { "mcpServers": { "@aerostack/mcp-freshdesk": { "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-freshdesk"] } } } ``` Then restart Claude Desktop and the tools will appear automatically.
How do I use the Freshdesk MCP server in Cursor? +
In Cursor, open **Settings → MCP** and add: ```json { "name": "@aerostack/mcp-freshdesk", "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-freshdesk"] } ``` Save and reload Cursor. The MCP tools will be available in Agent mode.
Does Freshdesk MCP require authentication? +
Yes. Freshdesk requires authentication. Check the MCP's documentation for the required credentials.