freshservice-mcp
Enables AI models to perform IT service management operations on Freshservice, including managing tickets, changes, problems, releases, assets, projects, and more through a set of MCP tools.
README
Freshservice MCP Server
Overview
A powerful MCP (Model Context Protocol) server that integrates with Freshservice, enabling AI models to perform IT service management operations. This integration bridge empowers your AI assistants to manage tickets, changes, problems, releases, assets, projects, and more.
Key Features
- 36 tools organized into 13 independently loadable scopes
- Dual authentication: per-user OAuth2 (via MCP gateway) with API key fallback
- Multiple transports: stdio (local), SSE, and streamable-http
- Dynamic form discovery: auto-discover custom fields for any entity type
- Scope-based loading: load only the tool modules you need
- Docker & Helm: ready for Kubernetes deployment
Architecture
| Scope | Tools | Description |
|---|---|---|
tickets |
manage_ticket, manage_ticket_conversation, manage_service_catalog |
Ticket CRUD, conversations, service catalog |
changes |
manage_change, manage_change_note, manage_change_task, manage_change_time_entry, manage_change_approval |
Change requests with full sub-resource support |
problems |
manage_problem, manage_problem_note, manage_problem_task, manage_problem_time_entry |
Problem management |
releases |
manage_release, manage_release_note, manage_release_task, manage_release_time_entry |
Release management |
assets |
manage_asset, manage_asset_details, manage_asset_relationship |
Assets/CMDB |
status_page |
manage_status_page, manage_maintenance_window |
Status pages, maintenance, incidents |
departments |
manage_department, manage_location |
Departments & locations |
agents |
get_me, manage_agent, manage_agent_group |
Identity, agents & groups |
requesters |
manage_requester, manage_requester_group |
Requesters & groups |
solutions |
manage_solution |
Knowledge base |
projects |
manage_project, manage_project_task |
Project management (NewGen) |
products |
manage_product |
Product catalog |
misc |
manage_canned_response, manage_workspace |
Canned responses, workspaces |
Plus 2 discovery tools always loaded: discover_form_fields and clear_field_cache.
Quick Start
Local Development (API key + stdio)
FRESHSERVICE_APIKEY=<key> FRESHSERVICE_DOMAIN=yourcompany.freshservice.com freshservice-mcp
Kubernetes / Gateway (OAuth2 + SSE)
helm install freshservice-mcp oci://ghcr.io/forterro/charts/freshservice-mcp \
--version 0.2.0 \
--set config.FRESHSERVICE_DOMAIN=yourcompany.freshservice.com
No API key needed — the MCP gateway forwards per-user OAuth2 tokens.
Documentation
| Document | Description |
|---|---|
| Authentication | API key setup, OAuth2 via gateway, creating a Freshservice OAuth app, JWT token structure |
| Deployment | Local, Docker, Helm chart, client configs (Claude Desktop, VS Code), transports, scopes, troubleshooting |
| Tools Reference | Complete reference for all 36 tools with actions and parameters |
| Examples | Example prompts for common operations |
License
MIT License. See the LICENSE file for details.
Additional Resources
<p align="center">Built with ❤️ by effy</p>
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.