Log inSubmit server
Freshdesk MCP logo

Freshdesk MCP

by effytech

Connects AI agents to Freshdesk for ticket, conversation, agent, contact, and company operations.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Freshdesk MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "effytech-freshdesk-mcp": {
      "command": "uvx",
      "args": [
        "freshdesk-mcp"
      ],
      "env": {
        "FRESHDESK_API_KEY": "YOUR_VALUE_HERE",
        "FRESHDESK_DOMAIN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

The install command didn't complete successfully in our automated test.

uvx freshdesk-mcp

Downloading pydantic-core (2.1MiB) Downloading cryptography (4.5MiB) Downloading pygments (1.2MiB) Downloaded pygments Downloaded pydantic-core Downloaded cryptography Installed 43 packages in 20ms Traceback (most recent call last): File "/home/user/.cache/uv/archive-v0/TkPYpXXgceXX74Rx/bin/freshdesk-mcp", line 6, in <module> from freshdesk_mcp.server import main File "/home/user/.cache/uv/archive-v0/TkPYpXXgceXX74Rx/lib/python3.11/site-packages/freshdesk_mcp/__init__.py", line 1, in

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 20d ago.

Overview

effytech/freshdesk-mcp MCP server connects AI models to Freshdesk through its API. It exposes tools for managing tickets, replies, notes, conversations, summaries, agents, contacts, and companies. The server runs through `uvx` and requires a Freshdesk API key and domain. Reach for it when an MCP-compatible client needs to read or modify Freshdesk support data.

Use cases

  • Create Freshdesk tickets from natural-language support requests
  • Search and review tickets, conversations, and summaries
  • Reply to tickets or add internal notes
  • Manage Freshdesk agents, contacts, and companies

Key features

  • Create, update, search, retrieve, and delete tickets
  • Add ticket replies and notes
  • Read and update ticket conversations and summaries
  • Manage agents and contacts
  • Search and inspect companies and custom fields

Tools28

What Freshdesk MCP lets your agent do. Expand a tool for its parameters.

Self-reported~254 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

24/24 checks healthy over the last 85d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · freshdesk-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars71Stargazers on the source repository.
Last commit19d agoMost recent push to the default branch.
Install checkInconclusiveInstall command did not finish in our automated test.
Tools exposed28Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Freshdesk MCP works

What effytech/freshdesk-mcp MCP server does

effytech/freshdesk-mcp MCP server gives an AI client access to Freshdesk support operations through MCP tools. It covers the main ticket lifecycle, including creation, retrieval, search, updates, deletion, replies, internal notes, conversation changes, and ticket summaries.

The available operations also extend to Freshdesk records related to support work. Agents can be listed, searched, viewed, created, and updated. Contacts can be listed, searched, viewed, and updated. Companies can be listed, searched, viewed, looked up by name, and inspected through their available fields.

How it works

The client starts the server locally and passes Freshdesk credentials through environment variables. Tool calls are translated into requests to the Freshdesk API, allowing the connected model to read records or request changes based on the tool and its inputs.

Several collection tools accept pagination values, including ticket, agent, contact, and company listing operations. Search tools accept a query string, while individual record operations require the relevant Freshdesk ID. Ticket creation accepts required subject, description, source, priority, and status values, with optional requester and custom-field data.

Setup and configuration

A Freshdesk account, API key, and domain are required. The configuration uses these environment variables:

  • FRESHDESK_API_KEY: Freshdesk API key.
  • FRESHDESK_DOMAIN: Freshdesk domain, such as yourcompany.freshdesk.com.

The documented local setup uses uvx, which can be installed with pip install uv or Homebrew. A Claude Desktop configuration starts uvx with the freshdesk-mcp package and supplies the two environment variables. The project also documents installation through Smithery for Claude Desktop:

Terminal
npx -y @smithery/cli install @effytech/freshdesk_mcp --client claude

For manual testing, the server can be launched with uvx freshdesk-mcp and the credentials supplied through --env arguments. Verify the API key, domain, network access, API quotas, and availability of uvx if requests fail.

Tools and capabilities

The ticket tools support creating, updating, deleting, searching, listing, and retrieving tickets. Separate tools retrieve ticket fields, conversations, and summaries. Reply and note tools add customer-facing replies or ticket notes, while another tool updates an existing conversation.

Agent management includes get_agents, view_agent, create_agent, update_agent, and search_agents. Contact management includes listing, retrieval, search, and updates. Company tools provide listing, retrieval, search, name-based lookup, and access to company fields.

Limitations and notes

Ticket creation requires numeric source, priority, and status values, so callers need to provide values accepted by the target Freshdesk account. Destructive actions such as deleting tickets or summaries are exposed as separate tools and should be handled with appropriate authorization.

Freshdesk API rate limits and quotas may affect requests. The documentation names Claude Desktop as the configured client and does not describe client-specific behavior for other MCP applications. effytech/freshdesk-mcp MCP server is licensed under MIT.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Freshdesk MCP

effytech/freshdesk-mcp is an MCP server that connects AI models to Freshdesk through the Freshdesk API. Its main tools create, update, delete, search, and retrieve tickets; manage replies, notes, conversations, and summaries; and work with agents, contacts, and companies.

Install it with `uvx` or Smithery for Claude Desktop. The documented Smithery command is `npx -y @smithery/cli install @effytech/freshdesk_mcp --client claude`; manual configuration starts the `freshdesk-mcp` package with `uvx`.

It requires `FRESHDESK_API_KEY` and `FRESHDESK_DOMAIN`. Set the first to a Freshdesk API key and the second to the Freshdesk domain, such as `yourcompany.freshdesk.com`.

It can create, update, delete, search, list, and retrieve tickets. It can also retrieve fields and conversations, add replies or notes, update conversations, and view, update, or delete ticket summaries.

Related MCP servers

All in Support & Service Management All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewFreshdesk MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/effytech-freshdesk-mcp?style=directory)](https://allmcps.com/mcp/effytech-freshdesk-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/effytech-freshdesk-mcp"><img src="https://allmcps.com/api/badge/effytech-freshdesk-mcp?style=directory" alt="Freshdesk MCP on AllMCPs" /></a>