MCP server
Freshdesk MCP by usefulapi
Read tickets, contacts, companies, agents and groups; create, update and reply to tickets.
- Runs
- Remotely
- Version
- 1.41.0
- Listing updated
- 4 days ago
About Freshdesk MCP by usefulapi
Freshdesk MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Install
Run in a terminal
claude mcp add --transport http freshdesk https://freshdesk.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://freshdesk.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"freshdesk": {
"url": "https://freshdesk.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"freshdesk": {
"type": "http",
"url": "https://freshdesk.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"freshdesk": {
"serverUrl": "https://freshdesk.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"freshdesk": {
"type": "http",
"url": "https://freshdesk.usefulapi.io/mcp"
}
}
}Tools this server provides (19)
Read directly from the server.
- freshdesk_list_tickets
- List/filter tickets (max page 300). Freshdesk REST: GET /tickets.
- freshdesk_get_ticket
- Get a single ticket by id. Freshdesk REST: GET /tickets/{id}.
- freshdesk_search_tickets
- Search tickets with the Freshdesk query DSL. The query VALUE is wrapped in double quotes automatically. Examples: `status:2 AND priority:3`, `created_at:>'2026-01-01'`, `agent_id:123`, `group_id:45`, `tag:'urgent'`. Freshdesk REST: GET /search/tickets.
- freshdesk_list_ticket_conversations
- List the conversations (replies and notes) on a ticket. Freshdesk REST: GET /tickets/{id}/conversations.
- freshdesk_list_contacts
- List/filter contacts. Freshdesk REST: GET /contacts.
- freshdesk_get_contact
- Get a single contact by id. Freshdesk REST: GET /contacts/{id}.
- freshdesk_search_contacts
- Search contacts with the Freshdesk query DSL. The query VALUE is wrapped in double quotes automatically. Examples: `name:'ada'`, `email:'ada@example.com'`, `company_id:123`. Freshdesk REST: GET /search/contacts.
- freshdesk_list_companies
- List companies. Freshdesk REST: GET /companies.
- freshdesk_get_company
- Get a single company by id. Freshdesk REST: GET /companies/{id}.
- freshdesk_list_agents
- List/filter agents. Freshdesk REST: GET /agents.
- freshdesk_get_agent
- Get a single agent by id. Freshdesk REST: GET /agents/{id}.
- freshdesk_list_groups
- List groups (agent groups tickets are routed to). Freshdesk REST: GET /groups.
- freshdesk_create_ticket
- Create a ticket. `subject` and `description` (HTML) are required, plus a requester — provide at least one of `email`, `requester_id`, or `phone`. status: 2=Open, 3=Pending, 4=Resolved, 5=Closed. priority: 1=Low, 2=Medium, 3=High, 4=Urgent. source: 1=Email, 2=Portal, 3=Phone, 7=Chat, 9=Feedbackwidget, 10=Outbound email. Freshdesk REST: POST /tickets.
- freshdesk_update_ticket
- Update fields on an existing ticket. Only provided fields are changed. status: 2=Open, 3=Pending, 4=Resolved, 5=Closed. priority: 1=Low, 2=Medium, 3=High, 4=Urgent. Freshdesk REST: PUT /tickets/{id}.
- freshdesk_reply_ticket
- Add a public reply to a ticket (sent to the requester). Freshdesk REST: POST /tickets/{id}/reply.
- freshdesk_add_note
- Add a note to a ticket. Notes are internal (private) by default; set `private: false` for a public note. Freshdesk REST: POST /tickets/{id}/notes.
- freshdesk_create_contact
- Create a contact. `name` is required. Freshdesk REST: POST /contacts.
- freshdesk_update_contact
- Update fields on an existing contact. Only provided fields are changed. Freshdesk REST: PUT /contacts/{id}.
- freshdesk_create_company
- Create a company. `name` is required. Freshdesk REST: POST /companies.
Freshdesk MCP by usefulapi FAQ
How do I add Freshdesk MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http freshdesk https://freshdesk.usefulapi.io/mcp