How do I use Freshservice MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Freshservice MCP Server show me all open high priority tickets" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Freshservice MCP Server

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.

Features

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)

Setup

1. Install dependencies

npm install

2. Configure secrets

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

3. Local development

npm run dev

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

4. Deploy

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

Connecting to Claude Desktop

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>"
      ]
    }
  }
}

Available Tools (159 total)

Each tool description is prefixed with the minimum Freshservice plan required: [Plan: Starter+], [Plan: Growth+], or [Plan: Pro+].

Starter+ (all plans)

Module	Tools
Tickets (15)	`list_tickets`, `get_ticket`, `create_ticket`, `update_ticket`, `delete_ticket`, `list_ticket_conversations`, `add_ticket_note`, `reply_to_ticket`, `list_ticket_time_entries`, `create_ticket_time_entry`, `update_ticket_time_entry`, `delete_ticket_time_entry`, `list_ticket_tasks`, `create_ticket_task`, `list_ticket_approvals`
Agents/Requesters (8)	`list_agents`, `get_agent`, `create_agent`, `update_agent`, `delete_agent`, `list_requesters`, `get_requester`, `list_requester_fields`
Knowledge Base (13)	`search_articles`, `get_article`, `create_article`, `update_article`, `delete_article`, `list_solution_categories`, `get_solution_category`, `create_solution_category`, `list_solution_folders`, `get_solution_folder`, `create_solution_folder`, `update_solution_folder`, `delete_solution_folder`
Departments (5)	`list_departments`, `get_department`, `create_department`, `update_department`, `delete_department`
Locations (5)	`list_locations`, `get_location`, `create_location`, `update_location`, `delete_location`
Agent Groups (5)	`list_groups`, `get_group`, `create_group`, `update_group`, `delete_group`
Requester Groups (5)	`list_requester_groups`, `get_requester_group`, `create_requester_group`, `update_requester_group`, `delete_requester_group`
Roles (2)	`list_roles`, `get_role`
Announcements (5)	`list_announcements`, `get_announcement`, `create_announcement`, `update_announcement`, `delete_announcement`
Canned Responses (5)	`list_canned_responses`, `get_canned_response`, `create_canned_response`, `update_canned_response`, `delete_canned_response`
Surveys (5)	`list_surveys`, `get_survey`, `create_survey`, `update_survey`, `delete_survey`

Growth+ (Growth, Pro, Enterprise)

Module	Tools
Assets (6)	`list_assets`, `get_asset`, `create_asset`, `update_asset`, `delete_asset`, `list_asset_contracts`
Asset Types (5)	`list_asset_types`, `get_asset_type`, `create_asset_type`, `update_asset_type`, `delete_asset_type`
Service Catalog (4)	`list_service_catalog_items`, `get_service_catalog_item`, `request_service_catalog_item`, `list_service_catalog_categories`
Vendors (5)	`list_vendors`, `get_vendor`, `create_vendor`, `update_vendor`, `delete_vendor`
Products (5)	`list_products`, `get_product`, `create_product`, `update_product`, `delete_product`
Purchase Orders (5)	`list_purchase_orders`, `get_purchase_order`, `create_purchase_order`, `update_purchase_order`, `delete_purchase_order`
Business Hours (5)	`list_business_hours`, `get_business_hours_config`, `create_business_hours`, `update_business_hours`, `delete_business_hours`
Onboarding (3)	`list_onboarding_requests`, `get_onboarding_request`, `create_onboarding_request`

Pro+ (Pro, Enterprise)

Module	Tools
Changes (10)	`list_changes`, `get_change`, `create_change`, `update_change`, `delete_change`, `add_change_note`, `list_change_time_entries`, `create_change_time_entry`, `list_change_tasks`, `create_change_task`
Problems (10)	`list_problems`, `get_problem`, `create_problem`, `update_problem`, `delete_problem`, `add_problem_note`, `list_problem_time_entries`, `create_problem_time_entry`, `list_problem_tasks`, `create_problem_task`
Releases (10)	`list_releases`, `get_release`, `create_release`, `update_release`, `delete_release`, `add_release_note`, `list_release_time_entries`, `create_release_time_entry`, `list_release_tasks`, `create_release_task`
Projects (8)	`list_projects`, `get_project`, `create_project`, `update_project`, `delete_project`, `list_project_tasks`, `create_project_task`, `add_project_note`
Contracts (5)	`list_contracts`, `get_contract`, `create_contract`, `update_contract`, `delete_contract`
Custom Objects (5)	`list_custom_objects`, `get_custom_object`, `create_custom_object`, `update_custom_object`, `delete_custom_object`

Tech Stack

TypeScript on Cloudflare Workers
agents (Cloudflare's agents-sdk, includes @modelcontextprotocol/sdk)
hono web framework
zod schema validation

Authentication

The MCP endpoint requires a Bearer token in the Authorization header. The Freshservice API is accessed using Basic Auth with your API key (stored as a Cloudflare Worker secret).

License

MIT

Freshservice MCP Server

Freshservice MCP Server

Features

Setup

1. Install dependencies

2. Configure secrets

3. Local development

4. Deploy

Connecting to Claude Desktop

Available Tools (159 total)

Starter+ (all plans)

Growth+ (Growth, Pro, Enterprise)

Pro+ (Pro, Enterprise)

Tech Stack

Authentication

License

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API