The Freshservice MCP Server enables AI models like Claude to perform comprehensive IT service management operations by integrating with Freshservice's API to automate and streamline various workflows.
Core Capabilities:
Ticket Management: Create, update, delete, retrieve, and filter service tickets with full pagination support. Send replies, add notes, manage conversations, and create service requests from catalog items.
Change Management: Handle change requests including creation, updates, closing with explanations, task retrieval, and note creation.
User Management: Create, update, filter, and manage both requesters and agents with detailed profile information and field management.
Group Management: Handle agent groups and requester groups, including creation, updates, member management, and retrieval.
Product/Asset Management: Create, update, retrieve, and list product information and asset details.
Knowledge Base Management: Create, update, and publish solution articles; manage categories and folders with full content organization.
Service Catalog: Access service items and create service requests from available catalog offerings.
Canned Responses: Access and manage pre-written response templates and organize them in folders.
Workspace Management: List and retrieve workspace configurations for multi-tenant environments.
Advanced Filtering: Use query-based filtering across tickets, changes, requesters, and agents with proper syntax requirements.
This integration streamlines IT operations by providing programmatic access to Freshservice's full feature set through a unified interface.
Freshservice MCP Server
Overview
A powerful MCP (Model Context Protocol) server implementation that seamlessly integrates with Freshservice, enabling AI models to interact with Freshservice modules and perform various IT service management operations. This integration bridge empowers your AI assistants to manage and resolve IT service tickets, streamlining your support workflow.
Related MCP server: MISP-MCP-SERVER
Key Features
Enterprise-Grade Freshservice Integration: Direct, secure communication with Freshservice API endpoints
AI Model Compatibility: Enables Claude and other AI models to execute service desk operations through Freshservice
Automated ITSM Management: Efficiently handle ticket creation, updates, responses, and asset management
Workflow Acceleration: Reduce manual intervention in routine IT service tasks
Supported Freshservice Modules
This MCP server currently supports operations across a wide range of Freshservice modules:
Tickets
Changes
Conversations
Products
Requesters
Agents
Agent Groups
Requester Groups
Canned Responses
Canned Response Folders
Workspaces
Solution Categories
Solution Folders
Solution Articles
Components & Tools
The server provides a comprehensive toolkit for Freshservice operations:
Ticket Management
Tool | Description | Key Parameters |
| Create new service tickets |
,
,
,
,
,
|
| Update existing tickets |
,
|
| Remove tickets |
|
| Find tickets matching criteria |
|
| Retrieve ticket field definitions | None |
| List all tickets with pagination |
,
|
| Retrieve single ticket details |
|
Change Management
Tool | Description | Key Parameters |
| List all changes with pagination |
,
,
|
| Filter changes with advanced queries |
,
,
|
| Retrieve single change details |
|
| Create new change request |
,
,
,
,
,
,
,
|
| Update existing change |
,
|
| Close change with result explanation |
,
|
| Remove change |
|
| Get tasks for a change |
|
| Add note to change |
,
|
🚨 Important: Query Syntax for Filtering
When using get_changes or filter_changes with the query parameter, the query string must be wrapped in double quotes for the Freshservice API to work correctly:
✅ CORRECT: "status:3", "approval_status:1 AND status:<6"
❌ WRONG: status:3 (will cause 500 Internal Server Error)
Common Query Examples:
"status:3"- Changes awaiting approval"approval_status:1"- Approved changes"approval_status:1 AND status:<6"- Approved changes that are not closed"planned_start_date:>'2025-07-14'"- Changes starting after specific date"status:3 AND priority:1"- High priority changes awaiting approval
Getting Started
Installing via Smithery
To install freshservice_mcp automatically via Smithery:
Prerequisites
A Freshservice account (sign up at freshservice.com)
Freshservice API key
uvxinstalled (pip install uvorbrew install uv)
Configuration
Generate your Freshservice API key from the admin panel:
Navigate to Profile Settings → API Settings
Copy your API key for configuration
Set up your domain and authentication details as shown below
Usage with Claude Desktop
Install Claude Desktop from the official website
Add the following configuration to your
claude_desktop_config.json:
Important: Replace <YOUR_FRESHSERVICE_APIKEY> with your actual API key and <YOUR_FRESHSERVICE_DOMAIN> with your domain (e.g., yourcompany.freshservice.com)
Example Operations
Once configured, you can ask Claude to perform operations like:
Tickets:
"Create a new incident ticket with subject 'Network connectivity issue in Marketing department' and description 'Users unable to connect to Wi-Fi in Marketing area', set priority to high"
"List all critical incidents reported in the last 24 hours"
"Update ticket #12345 status to resolved"
Changes:
"Create a change request for scheduled server maintenance next Tuesday at 2 AM"
"Update the status of change request #45678 to 'Approved'"
"Close change #5092 with result explanation 'Successfully deployed to production. All tests passed.'"
"List all pending changes"
Other Operations:
"Show asset details for laptop with asset tag 'LT-2023-087'"
"Create a solution article about password reset procedures"
Testing
For testing purposes, you can start the server manually:
Troubleshooting
Verify your Freshservice API key and domain are correct
Ensure proper network connectivity to Freshservice servers
Check API rate limits and quotas
Verify the
uvxcommand is available in your PATH
License
This MCP server is licensed under the MIT License. See the LICENSE file in the project repository for full details.