freshservice-mcp

A fully-featured MCP (Model Context Protocol) server for Freshservice ITSM, deployed on Cloudflare Workers. Exposes 159 tools covering every Freshservice API v2 endpoint — tickets, assets, changes, problems, releases, projects, service catalog, knowledge base, and more.

• 159 tools across 25 modules covering the full Freshservice API v2
• Cloudflare Workers — globally distributed, serverless, no cold starts
• Streamable HTTP transport (modern MCP standard)
• Bearer token auth to protect the MCP endpoint
• Plan-aware — each tool description indicates the minimum Freshservice plan required (Starter, Growth, or Pro)

npm install

Copy .dev.vars.example to .dev.vars for local development:

cp .dev.vars.example .dev.vars

Edit .dev.vars with your values:

• FRESHSERVICE_API_KEY: Your Freshservice API key (Profile Settings > API Key)
• FRESHSERVICE_DOMAIN: Your subdomain (e.g., yourcompany for yourcompany.freshservice.com)
• MCP_AUTH_TOKEN: Bearer token to protect the endpoint. Generate: openssl rand -hex 32

npm run dev

Server starts at http://localhost:8787. Health check at GET /, MCP endpoint at POST /mcp.

npx wrangler secret put FRESHSERVICE_API_KEY
npx wrangler secret put FRESHSERVICE_DOMAIN
npx wrangler secret put MCP_AUTH_TOKEN
npm run deploy

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "freshservice": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://freshservice-mcp.<your-account>.workers.dev/mcp",
        "--header",
        "Authorization: Bearer <YOUR_MCP_AUTH_TOKEN>"
      ]
    }
  }
}

Each tool description is prefixed w