Freshdeck MCP Server
Manage Freshdesk tickets, contacts, and agents using the Model Context Protocol.
Data last scanned today · Reviewed today
Overview
The Freshdeck MCP Server acts as an interface between your AI and the Freshdesk API v2. It provides structured tools for interacting with support tickets, customer contacts, and agent profiles, allowing AI models to create, update, search, and delete resources directly.
Our verdict
This server carries a high risk level with a security score of 27/100. It is community-maintained rather than official and lacks any specified license, which may present legal ambiguity for users. Given that it currently provides full write access without a read-only mode, it should be treated with caution in production environments.
- Built with TypeScript for type safety
- Includes automatic rate limit handling
- Implements retry logic with exponential backoff
- Small footprint with only eight direct dependencies
- No license detected for use
- Lacks a dedicated read-only mode
- Community-maintained without official vendor support
Setup
{
"mcpServers": {
"freshdeck-mcp": {
"args": [
"-y",
"freshdesk-mcp"
],
"command": "npx"
}
}
}Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Tools
| Tool | Description | Risk |
|---|---|---|
| tickets_manage | Manage Freshdesk tickets - create, update, list, get, delete, and search tickets. | high |
| contacts_manage | Manage Freshdesk contacts - create, update, list, get, delete, search, and merge contacts. | high |
| agents_manage | Manage Freshdesk agents - list, get, update agents, and view their groups and roles. | medium |
| companies_manage | Manage Freshdesk companies - create, update, list, get, delete, search companies, and list company contacts. | high |
| conversations_manage | Manage Freshdesk ticket conversations - create replies and notes, list, get, update, and delete conversations. | high |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf | ||||
| ChatGPT |
Frequently asked questions
›What configuration is required to run the server?
You must provide your Freshdesk domain and API key via environment variables. You can optionally configure rate limits, request timeouts, and retry logic.
›How does the server handle API rate limits?
The server automatically respects Freshdesk API rate limits by implementing throttling. You can adjust the rate limit per minute using the FRESHDESK_RATE_LIMIT environment variable.
›What happens if a network request fails?
The server includes built-in error handling with retry logic. It performs automatic retries for network errors using an exponential backoff strategy.
›Can I customize the logging output?
Yes, you can configure the verbosity of the structured logs by setting the LOG_LEVEL environment variable to debug, info, warn, or error.
›Does the server support managing ticket conversations?
Yes, the conversations_manage tool allows you to create replies and notes, as well as list, get, update, and delete ticket conversations.
Badge
Maintain this server? Add the live badge to your README.