Freshservice MCP Server
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Freshservice MCP ServerShow me all open P1 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
An MCP (Model Context Protocol) server that connects AI assistants to your Freshservice ITSM instance. Manage tickets, assets, changes, problems, service catalog, knowledge base, and more through natural language.
Features
53 tools across 9 categories:
Category | Tools | Description |
Tickets | 9 | List, get, create, update, delete, reply, add notes, conversations, search |
Assets | 5 | List, get, create, update, delete |
People | 8 | Requesters, agents, groups, departments (list + get) |
Ticket Tasks | 5 | List, get, create, update, delete sub-tasks on tickets |
Time Entries | 4 | List, create, update, delete time logs |
Changes | 5 | List, get, create, update, delete change requests |
Problems | 5 | List, get, create, update, delete problem records |
Service Catalog | 3 | Browse catalog items, get details, place service requests |
Knowledge Base | 9 | Categories, folders, articles (full CRUD) |
Quick Start
Prerequisites
Node.js 18+
A Freshservice account with API access
Your Freshservice API key (Profile icon > Profile Settings > API key on the right panel)
Install via npx (recommended)
No installation needed. Configure your MCP client to run:
{
"mcpServers": {
"freshservice": {
"command": "npx",
"args": ["-y", "freshservice-mcp"],
"env": {
"FRESHSERVICE_DOMAIN": "yourcompany",
"FRESHSERVICE_API_KEY": "your-api-key"
}
}
}
}Install globally
npm install -g freshservice-mcpThen configure your MCP client:
{
"mcpServers": {
"freshservice": {
"command": "freshservice-mcp",
"env": {
"FRESHSERVICE_DOMAIN": "yourcompany",
"FRESHSERVICE_API_KEY": "your-api-key"
}
}
}
}Install from source
git clone https://github.com/tannertm0/freshservice-mcp.git
cd freshservice-mcp
npm install{
"mcpServers": {
"freshservice": {
"command": "node",
"args": ["/path/to/freshservice-mcp/src/index.js"],
"env": {
"FRESHSERVICE_DOMAIN": "yourcompany",
"FRESHSERVICE_API_KEY": "your-api-key"
}
}
}
}Configuration
Variable | Required | Description |
| Yes | Your Freshservice subdomain (e.g. |
| Yes | Your Freshservice API key |
MCP Client Setup
Claude Desktop - Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
Claude Code - Run claude mcp add freshservice -- npx -y freshservice-mcp then set env vars
Cursor / VS Code - Add to your MCP settings following your editor's docs
Available Tools
Tickets
Tool | Description |
| List tickets with filters (status, priority, requester, date) |
| Get full ticket details |
| Create a new ticket |
| Update ticket fields (status, priority, assignment, etc.) |
| Delete a ticket (moves to trash) |
| Send a reply on a ticket |
| Add a public or private note |
| View all replies and notes |
| Filter tickets with query syntax |
Assets
Tool | Description |
| List all assets/CIs |
| Get asset details with custom fields |
| Register a new asset |
| Update asset fields |
| Remove an asset |
People & Organization
Tool | Description |
| End users |
| Support staff |
| Agent groups with members |
| Departments |
Ticket Tasks
Tool | Description |
| List sub-tasks on a ticket |
| Get task details |
| Add a task to a ticket |
| Update task status/assignment |
| Remove a task |
Time Entries
Tool | Description |
| View logged time on a ticket |
| Log time spent |
| Modify a time entry |
| Remove a time entry |
Changes
Tool | Description |
| List change requests |
| Get change details (type, risk, schedule) |
| Create a change request |
| Update change fields |
| Delete a change |
Problems
Tool | Description |
| List problem records |
| Get problem details |
| Create a problem record |
| Update problem fields |
| Delete a problem |
Service Catalog
Tool | Description |
| Browse available services |
| Get service details and required fields |
| Submit a service request |
Knowledge Base
Tool | Description |
| Browse KB categories |
| Browse KB folders |
| Read articles |
| Write a new article |
| Edit an article |
| Remove an article |
Example Prompts
Once configured, you can ask your AI assistant things like:
"Show me all open P1 tickets"
"Create a ticket for the printer on 3rd floor being offline"
"What assets are assigned to John Smith?"
"Add a private note to ticket #5678 saying we're waiting on the vendor"
"Create a change request for the firewall upgrade scheduled next Tuesday"
"Search the knowledge base for VPN setup instructions"
"Log 2 hours on ticket #1234 for debugging the network issue"
"Show me all open problems and their impact levels"
"Place a new laptop request from the service catalog"
Search Query Syntax
The search_tickets tool uses Freshservice's filter query syntax:
"priority:4 AND status:2" - Urgent + Open tickets
"group_id:12345" - Tickets assigned to a specific group
"agent_id:67890" - Tickets assigned to a specific agent
"created_at:>'2024-01-01'" - Tickets created after a dateDevelopment
git clone https://github.com/tannertm0/freshservice-mcp.git
cd freshservice-mcp
npm install
npm testLicense
MIT
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/tannertm0/freshservice-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server