Freshdesk

You can run a Freshdesk MCP Server to integrate Freshdesk API v2 resources with an MCP client, enabling centralized management of tickets, contacts, agents, companies, and conversations through the MCP interface. This server provides built-in authentication, rate limiting, error handling, and type-safe tooling to streamline automation and data synchronization with Freshdesk.

How to use

Set up and run the Freshdesk MCP Server locally or in your environment, then connect your MCP client to it. You will use an MCP client configuration that points to the local stdio server, providing the command and arguments needed to launch the server process and the required environment variables. Once running, you can perform operations such as creating and updating tickets, contacts, agents, companies, and conversations through the MCP endpoints.

How to install

Prerequisites you need installed before starting are Node.js and npm. You will also build the server from source and then run it in development or production mode.

# Install dependencies
npm install
# Build the server
npm run build

Configuration and startup

Provide the required environment variables for Freshdesk access. Create a .env file at the project root with these values set.

# Required
FRESHDESK_DOMAIN=yourcompany.freshdesk.com  # or just "yourcompany"
FRESHDESK_API_KEY=your_api_key_here

# Optional
FRESHDESK_MAX_RETRIES=3          # Maximum retry attempts (default: 3)
FRESHDESK_TIMEOUT=30000          # Request timeout in ms (default: 30000)
FRESHDESK_RATE_LIMIT=50          # Rate limit per minute (default: 50)
LOG_LEVEL=info                   # Log level: debug, info, warn, error

Starting the server

In development, you can run the server with auto-reload. In production, start the server normally.

# Development mode with auto-reload
npm run dev

# Production mode
npm start

Connecting via an MCP client

Configure your MCP client to use the stdio-based server by providing the exact command and arguments to launch the server process, along with the required environment variables.

{
  "mcpServers": {
    "freshdesk": {
      "command": "node",
      "args": ["/path/to/freshdesk-mcp/dist/index.js"],
      "env": {
        "FRESHDESK_DOMAIN": "yourcompany.freshdesk.com",
        "FRESHDESK_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available tools

tickets_manage

Manage Freshdesk tickets: create, update, list, get, delete, and search tickets.

contacts_manage

Manage Freshdesk contacts: create, update, list, get, delete, search, and merge contacts.

agents_manage

Manage Freshdesk agents: list, get, update, and view their groups and roles, including current authenticated agent.

companies_manage

Manage Freshdesk companies: create, update, list, get, delete, search, and list contacts within a company.

conversations_manage

Manage Freshdesk ticket conversations: create replies and notes, list, get, update, and delete conversations.