# Freshdesk

Connects Freshdesk to your AI assistant to handle support tickets, reply to users, and query help articles. Useful when managing helpdesk queues directly from your coding setup.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 13
- Author: mindstone
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mindstone/mcp-servers/tree/HEAD/connectors/freshdesk
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/freshdesk

## What it does

The server provides 20 tools covering helpdesk workflows. It handles tickets, customer replies, private notes, and contact lookups. Knowledge base search is included.

Execution requires Node.js 20 or newer and npm. Account API credentials stay on your machine inside `accounts.json`, located under `FRESHDESK_CONFIG_PATH` with strict `0600` file permissions.

For safety, the connector wraps text responses from Freshdesk inside `<untrusted-content>` tags. This keeps prompt injections contained. Without write permissions to the config directory, credential storage fails immediately.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `FRESHDESK_CONFIG_PATH` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env FRESHDESK_CONFIG_PATH=<FRESHDESK_CONFIG_PATH> --transport stdio freshdesk -- npx -y @mindstone/mcp-server-freshdesk
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add freshdesk --env FRESHDESK_CONFIG_PATH=<FRESHDESK_CONFIG_PATH> -- npx -y @mindstone/mcp-server-freshdesk
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "freshdesk": {
            "command": "npx",
            "args": [
                "-y",
                "@mindstone/mcp-server-freshdesk"
            ],
            "env": {
                "FRESHDESK_CONFIG_PATH": "<FRESHDESK_CONFIG_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "freshdesk": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@mindstone/mcp-server-freshdesk"
            ],
            "env": {
                "FRESHDESK_CONFIG_PATH": "<FRESHDESK_CONFIG_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e FRESHDESK_CONFIG_PATH=<FRESHDESK_CONFIG_PATH> freshdesk npx -y @mindstone/mcp-server-freshdesk
```
Replace <…> with your own values

## When to use it
- reply to customer support tickets directly from the assistant
- search support issues using Freshdesk query syntax
- look up solution articles in the knowledge base
- retrieve client profiles and company details

## Example prompts
- Find all urgent tickets in Freshdesk opened during the past 24 hours.
- Post a public reply to ticket 1042 explaining the planned maintenance window.
- Search the knowledge base for instructions on setting up SSO.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

From the same set: [mindstone/mcp-servers](https://affpapa.org/en/nevibecode/by/mindstone/mcp-servers.md) — 40 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md