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.
- 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
| 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.
FRESHSERVICE_APIKEY=<key> FRESHSERVICE_DOMAIN=yourcompany.freshservice.com freshservice-mcphelm install freshservice-mcp oci://ghcr.io/forterro/charts/freshservice-mcp \
--version 0.2.0 \
--set config.FRESHSERVICE_DOMAIN=yourcompany.freshservice.comNo API key needed — the MCP gateway forwards per-user OAuth2 tokens.
| 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 |
MIT License. See the LICENSE file for details.
Built with ❤️ by effy