# Freshdesk MCP by usefulapi

> Freshdesk MCP by usefulapi is an MCP server. Read tickets, contacts, companies, agents and groups; create, update and reply to tickets. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/freshdesk/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/freshdesk
- **MCP Registry name:** io.usefulapi/freshdesk
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http freshdesk https://freshdesk.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://freshdesk.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "freshdesk": {
      "url": "https://freshdesk.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "freshdesk": {
      "type": "http",
      "url": "https://freshdesk.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "freshdesk": {
      "serverUrl": "https://freshdesk.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "freshdesk": {
      "type": "http",
      "url": "https://freshdesk.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/freshdesk-mcp-by-usefulapi
