Freshdesk MCP by usefulapi
RemoteAbout Freshdesk MCP by usefulapi
Freshdesk MCP by usefulapi is a hosted MCP server for teams working with Freshdesk support data. It lets MCP clients inspect tickets and related records, then create or update tickets and contacts, reply, and add notes.
Key features
- 01List, inspect and search tickets
- 02Read ticket conversations
- 03Browse contacts and companies
- 04View agents and groups
- 05Create, update and reply to tickets
- 06Add ticket notes and manage contacts
Use cases
- 01Find a ticket by search
- 02Review a ticket's conversation history
- 03Reply to a support request or add a note
- 04Create or update a contact or company
MCP support
Exposes Freshdesk tickets, conversations, contacts, companies, agents and groups as MCP tools, including ticket and contact write operations. The hosted server connects using the Freshdesk domain and API key supplied during sign-in.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://freshdesk.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-freshdesk https://freshdesk.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-freshdesk":{"type":"http","url":"https://freshdesk.usefulapi.io/mcp"}}}Open in Cursor{"servers":{"io-usefulapi-freshdesk":{"type":"http","url":"https://freshdesk.usefulapi.io/mcp"}}}Open in VS Code{"mcpServers":{"io-usefulapi-freshdesk":{"type":"http","url":"https://freshdesk.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-freshdesk":{"serverUrl":"https://freshdesk.usefulapi.io/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
19| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | No | Page number for pagination (1-based). |
| string | No | Filter by requester email. | |
| filter | enum | No | Predefined filter: new_and_my_open, watching, spam, or deleted.new_and_my_open | watching | spam | deleted |
| include | string | No | Embed extra data, comma-separated, e.g. "requester,stats,description". |
| order_by | enum | No | Sort field: created_at, due_by, updated_at, or status.created_at | due_by | updated_at | status |
| per_page | integer | No | Results per page (1-100, max 100, default 30). |
| company_id | integer | No | Filter by company id. |
| order_type | enum | No | Sort direction: asc or desc.asc | desc |
| requester_id | integer | No | Filter by requester (contact) id. |
| updated_since | string | No | Only tickets updated after this ISO 8601 timestamp. |
Details
From the project READMEFreshdesk MCP by usefulapi
Use your Freshdesk account from Claude, Cursor, or any MCP client — read tickets, contacts, companies, agents and groups, and create, update or reply to tickets. Hosted, no local install: connect with your own credentials.
Live endpoint: https://freshdesk.usefulapi.io/mcp · Homepage: https://usefulapi.io
Connect
- Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste
https://freshdesk.usefulapi.io/mcp. - Claude Code:
claude mcp add --transport http freshdesk https://freshdesk.usefulapi.io/mcp, then run/mcpto log in. - VS Code: Add to VS Code.
- Cursor and other clients: add the URL as a remote MCP server:
{
"mcpServers": {
"freshdesk": {
"url": "https://freshdesk.usefulapi.io/mcp"
}
}
}
Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Freshdesk credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/freshdesk/
On first connect you'll provide your Freshdesk domain and API key (Profile settings). It is validated, stored per-user, and scoped to you — no keys in config files.
Tools
| Tool | Type | What it does |
|---|---|---|
freshdesk_list_tickets | read | List tickets |
freshdesk_get_ticket | read | Get ticket |
freshdesk_search_tickets | read | Search tickets |
freshdesk_list_ticket_conversations | read | List ticket conversations |
freshdesk_list_contacts | read | List contacts |
freshdesk_get_contact | read | Get contact |
freshdesk_search_contacts | read | Search contacts |
freshdesk_list_companies | read | List companies |
freshdesk_get_company | read | Get company |
freshdesk_list_agents | read | List agents |
freshdesk_get_agent | read | Get agent |
freshdesk_list_groups | read | List groups |
freshdesk_create_ticket | write | Create ticket |
freshdesk_update_ticket | write | Update ticket |
freshdesk_reply_ticket | write | Reply to ticket |
freshdesk_add_note | write | Add note to ticket |
freshdesk_create_contact | write | Create contact |
freshdesk_update_contact | write | Update contact |
freshdesk_create_company | write | Create company |
freshdesk_usage_status | meta | Usage status (free-tier meter) |
freshdesk_request_feature | meta | Request a missing feature |
freshdesk_upgrade | meta | Upgrade to Pro (unlimited*) |
freshdesk_cancel_subscription | meta | Cancel the Pro subscription |
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
Pricing
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 50 tool calls / month |
| Pro | $9/mo or $90/yr (2 months free) | Unlimited* |
*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].
Pro covers this server only. Subscribe with freshdesk_upgrade (it returns a Stripe Checkout link). Cancel any time with freshdesk_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running freshdesk_upgrade before then undoes the cancel. Or write to [email protected].
License
MIT — see LICENSE. Documentation only; the server is hosted.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.