Freshdesk MCP Server

A Model Context Protocol (MCP) server that fetches Freshdesk ticket details and provides them as context for LLM interactions.

Features

• get_ticket - Fetch complete ticket details from a Freshdesk URL or ticket ID

  • Ticket metadata (subject, status, priority, type, tags)
  • Requester and assignee information
  • All conversations (replies and private notes)
  • Attachments list
  • Time entries
  • Satisfaction ratings
  • Custom fields

• search_tickets - Search tickets by text query

  • Filter by status (open, pending, resolved, closed)
  • Filter by priority (low, medium, high, urgent)
  • Configurable result limit

• get_agent_tickets - Get tickets assigned to a specific agent

  • Search by agent name (supports partial matching)
  • Filter by status
  • Configurable result limit

Installation

Using npx (Recommended)

No installation required. Add directly to your config:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "freshdesk": {
      "command": "npx",
      "args": ["-y", "github:nikhilchintawar/freshdesk-mcp"],
      "env": {
        "FRESHDESK_API_KEY": "your-api-key",
        "FRESHDESK_DOMAIN": "yourcompany"
      }
    }
  }
}

Claude Code (~/.claude/settings.json):

{
  "mcpServers": {
    "freshdesk": {
      "command": "npx",
      "args": ["-y", "github:nikhilchintawar/freshdesk-mcp"],
      "env": {
        "FRESHDESK_API_KEY": "your-api-key",
        "FRESHDESK_DOMAIN": "yourcompany"
      }
    }
  }
}

Manual Installation

# Clone the repository
git clone https://github.com/nikhilchintawar/freshdesk-mcp.git
cd freshdesk-mcp

# Install dependencies
npm install

Then add to your config:

{
  "mcpServers": {
    "freshdesk": {
      "command": "node",
      "args": ["/absolute/path/to/freshdesk-mcp/build/index.js"],
      "env": {
        "FRESHDESK_API_KEY": "your-api-key",
        "FRESHDESK_DOMAIN": "yourcompany"
      }
    }
  }
}

Configuration

Config File Locations

• Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
• Claude Code: ~/.claude/settings.json

Environment Variables

Variable	Description	Required
FRESHDESK_API_KEY	Your Freshdesk API key	Yes
FRESHDESK_DOMAIN	Your Freshdesk subdomain (e.g., mycompany for mycompany.freshdesk.com)	Yes

Usage Examples

Once configured, you can use natural language to interact with Freshdesk:

• "Get the details of ticket https://mycompany.freshdesk.com/a/tickets/12345"
• "Search for tickets about 'login issue'"
• "Show me all open tickets assigned to John"
• "Find high priority tickets related to billing"

Getting Your Freshdesk API Key

1. Log in to your Freshdesk account
2. Click on your profile icon → Profile Settings
3. Your API key is displayed on the right side of the page

Development

# Watch mode for development
npm run dev

# Build for production
npm run build

# Test with MCP Inspector
FRESHDESK_API_KEY=your-key FRESHDESK_DOMAIN=your-domain \
  npx @modelcontextprotocol/inspector node build/index.js

License

MIT