Skip to content
MCP server

Freshdesk MCP by usefulapi

Read tickets, contacts, companies, agents and groups; create, update and reply to tickets.

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://freshdesk.usefulapi.io/mcp
Install 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