Freshservice MCP server (official, by Freshworks)
Lets your AI assistant work with Freshservice tickets, assets, service catalog and knowledge base, as you.
Freshworks' own server lets Claude, ChatGPT, Cursor and other assistants read and update Freshservice tickets, assets, service catalog requests and knowledge base articles. You sign in with your Freshservice account, and the assistant can only do what your role already allows. It is on Growth, Pro and Enterprise plans, and every call counts against a capped action allowance. Each account has its own address, and custom domains do not work.
Good for
- IT agents who want to check their queue, read tickets and add notes without leaving the assistant
- Service desk leads who want ticket and asset lookups answered in plain words
- IT teams handling onboarding and offboarding requests
- Employees on Freshservice who want to raise and follow their own requests from Claude or ChatGPT
- Knowledge base owners drafting and updating solution articles
Works in
5 supported · 8 should work
Tap an app to see how to set it up and any known problems.
Freshworks' docs cover it: add your account address through mcp-remote and sign in, or connect with your API key. support.freshservice.com
Freshworks' docs cover it: add Freshservice from Claude's Connectors, or add an mcp-remote entry with your account address and sign in. support.freshservice.com
Freshworks' docs cover it: add your account address to .cursor/mcp.json, then click Connect in MCP settings to sign in. support.freshservice.com
Freshworks' docs cover it: run MCP: Add Server, choose HTTP, paste your account address and allow the sign-in prompt. support.freshservice.com
Needs ChatGPT Enterprise: a workspace admin creates and publishes a Freshservice plugin, then users sign in. support.freshservice.com
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Client does not support this transport.
Install Freshservice MCP
Claude Code
- 1
Copy this prompt.
Add the Freshservice MCP server to Claude Code. Run this command: claude mcp add my-remote-server --transport stdio -- npx -y mcp-remote https://<subdomain>.freshservice.com/mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Freshservice Growth, Pro or Enterprise, An admin or agent role, or requester sign-in, Node.js for npx.
Read-only mode: Ask your Freshservice admin to turn off the create and update tools in the MCP settings.
Replace <subdomain> with your Freshservice account name. Custom domains do not work. For the API key method, use your personal Freshservice API key from your profile settings in the Authorization header, as is, with no Bearer prefix. Employees (requesters) must use sign-in. If sign-in fails, run /mcp inside Claude Code.
From the vendor's docs. Source.
Tools
Lists tickets, such as the open ones assigned to you
Gets the tickets you can see in Freshservice. For employees it returns only their own tickets.
Try: “Get all open tickets assigned to me.”
Read ·
fetchTicketsFinds tickets by status, priority, group or other fields
Filters tickets by the values of ticket fields, such as all urgent tickets in the Network group.
Try: “Show urgent tickets in the Network group created this week.”
Read ·
fetchTicketFilterShows the full details of one ticket
Gets one ticket by its number, with its fields, requester and status.
Try: “Show details for ticket 10234.”
Read ·
fetchTicketCreates a new ticket
Raises a new ticket in Freshservice with the details you give.
Try: “Create a ticket: my laptop will not connect to the office Wi-Fi.”
Write ·
createTicketChanges a ticket's status, priority, owner or other fields
Updates an existing ticket, for example to change its status, priority or the agent it is assigned to.
Try: “Set ticket 10234 to resolved.”
Write ·
updateTicketAdds a note to a ticket
Adds a note to an existing ticket, such as an internal note for other agents.
Try: “Add an internal note to ticket 1023: 'The issue is caused by a sudden router reboot.'”
Write ·
createTicketNoteReplies on one of your tickets
Posts a reply on a ticket. Freshworks lists it in the tools for employees (requesters).
Try: “Reply to my ticket 552 saying the issue is fixed.”
Write ·
replyTicketLists the assets in Freshservice, such as laptops and servers
Gets the assets recorded in Freshservice.
Try: “List all assets assigned to the London office.”
Read ·
fetchAssetsShows the details of one asset
Gets one asset by its ID, with its type, owner and fields.
Try: “Show details for asset 3381.”
Read ·
fetchAssetAdds a new asset
Creates a new asset record in Freshservice.
Try: “Add a new MacBook Pro asset assigned to jane@acme.com.”
Write ·
createAssetChanges an asset's details
Updates an existing asset record, such as its owner or location.
Try: “Reassign asset 3381 to the Berlin office.”
Write ·
updateAssetLists your service desk agents
Gets the agents in your Freshservice account.
Try: “Who are the agents in the Network group?”
Read ·
fetchAgentsShows one agent's details
Gets the details of one agent.
Try: “Show the details for agent Priya Shah.”
Read ·
fetchAgentLists the employees who raise requests
Gets the requesters (employees) in your account. Not available in single-account MSP mode.
Try: “List requesters in the Finance department.”
Read ·
fetchRequestersShows one employee's details
Gets the details of one requester. Not available in single-account MSP mode.
Try: “Look up the requester john@acme.com.”
Read ·
fetchRequesterShows an employee onboarding request
Gets the details of one employee onboarding request.
Try: “Show onboarding request 14.”
Read ·
fetchOnboardingRequestShows what an onboarding request needs
Gets the fields on the onboarding request form, so the assistant knows what to fill in.
Try: “What do I need to fill in to onboard a new hire?”
Read ·
fetchOnboardingRequestFormStarts onboarding for a new employee
Files an onboarding request so IT can set up a new employee.
Try: “Start onboarding for Alex Kim, starting Monday in Sales.”
Write ·
createOnboardingRequestLists employee offboarding requests
Gets all offboarding requests.
Try: “List this month's offboarding requests.”
Read ·
fetchOffboardingRequestsLists the tickets created for offboarding
Gets the tickets that offboarding requests created.
Try: “Show the open tickets for Sam Lee's offboarding.”
Read ·
fetchOffboardingRequestTicketsShows what an offboarding request needs
Gets the fields on the offboarding request form.
Try: “What do I need to offboard an employee?”
Read ·
fetchOffboardingRequestFormStarts offboarding for a leaving employee
Files an offboarding request so IT can remove access and collect equipment.
Try: “Start offboarding for Sam Lee, last day Friday.”
Write ·
createOffboardingRequestSearches the service catalog
Finds service catalog items that match a word, such as laptop or VPN.
Try: “Search the service catalog for 'laptop'.”
Read ·
fetchServiceCatalogItemSearchLists everything in the service catalog
Gets all items in the service catalog.
Try: “What can I request from IT?”
Read ·
fetchServiceCatalogItemsShows one service catalog item
Gets the details and fields of one catalog item.
Try: “What does the new laptop request need?”
Read ·
fetchServiceCatalogItemLists the service catalog's categories
Gets the categories of the service catalog. Freshworks lists it in the tools for employees (requesters).
Try: “What categories are in the service catalog?”
Read ·
fetchServiceCatalogCategoriesRequests an item from the service catalog for you or someone else
Places a service request for a catalog item, such as software or hardware.
Try: “Request a software installation for Zoom for john@acme.com.”
Write ·
placeRequestServiceCatalogItemSearches knowledge base articles
Finds solution articles that match a word or phrase.
Try: “Find solution articles for 'VPN issue'.”
Read ·
fetchSolutionArticleSearchShows one knowledge base article
Gets the full text of one solution article.
Try: “Show me the article on resetting my password.”
Read ·
fetchSolutionArticleLists the articles in a knowledge base folder
Gets the solution articles inside one folder.
Try: “List the articles in the Remote Work folder.”
Read ·
fetchSolutionArticlesLists knowledge base categories
Gets all solution categories in the knowledge base.
Try: “What knowledge base categories do we have?”
Read ·
fetchSolutionCategoriesShows one knowledge base category
Gets the details of one solution category.
Try: “Show the Hardware category.”
Read ·
fetchSolutionCategoryLists the folders in a knowledge base category
Gets the folders inside one solution category.
Try: “What folders are in the Software category?”
Read ·
fetchSolutionFoldersShows one knowledge base folder
Gets the details of one solution folder.
Try: “Show the VPN folder.”
Read ·
fetchSolutionFolderWrites a new knowledge base article
Creates a new solution article in a folder.
Try: “Write a knowledge base article on fixing VPN timeouts from ticket 1023.”
Write ·
createSolutionArticleEdits a knowledge base article
Updates the text or details of an existing solution article.
Try: “Update the password reset article with the new self-service link.”
Write ·
updateSolutionArticleAdds a folder to the knowledge base
Creates a new folder in a solution category.
Try: “Create a folder called Printers under Hardware.”
Write ·
createSolutionFolderLists your Freshservice workspaces
Gets all workspaces in the account, such as IT and HR.
Try: “Which workspaces do we have?”
Read ·
fetchWorkspacesLists agent groups
Gets all agent groups.
Try: “List the agent groups.”
Read ·
fetchGroupsLists departments
Gets all departments. Not available in single-account MSP mode.
Try: “List our departments.”
Read ·
fetchDepartmentsLists office locations
Gets all locations.
Try: “List our office locations.”
Read ·
fetchLocationsLists vendors
Gets all vendors recorded in Freshservice.
Try: “Which vendors do we have?”
Read ·
fetchVendorsLists products in the product catalog
Gets all products recorded in Freshservice.
Try: “List the products we track.”
Read ·
fetchProductsGets records from your custom objects
Gets the records stored in your account's custom objects.
Try: “Show the records in our software licences object.”
Read ·
fetchCustomObjectRecordsUsed by the assistant behind the scenes
Looks up the fields a ticket form has
Gets the fields on the ticket form, so the assistant can fill a ticket in correctly.
Try: “What fields does a new ticket need?”
Read ·
fetchTicketFormFieldsLooks up the asset types you use
Gets all asset types, so the assistant can file assets correctly.
Try: “What asset types do we use?”
Read ·
fetchAssetTypesLooks up the fields of an asset type
Gets the fields for one asset type, so the assistant can fill them in.
Try: “What fields does a laptop asset have?”
Read ·
fetchAssetTypeFields
From the official docs
Pros and cons
Good
- Made and hosted by Freshworks, so there is nothing to install for Claude, ChatGPT or Gemini.
- Sign in with your Freshservice account; the assistant gets only your role's access.
- Covers tickets, assets, onboarding and offboarding, service catalog and knowledge base.
- Admins can switch individual tools off and limit who can use it.
- No delete tools.
- Documented for eight AI apps, from Claude and ChatGPT to Cursor, VS Code and Copilot Studio.
- Freshworks documents a sign-in-only version for employees' own tickets and requests.
Watch out
- Only on Growth, Pro and Enterprise plans.
- Every call, read or write, counts against a capped action allowance.
- Custom domains do not work; you must use your freshservice.com address.
- ChatGPT needs an Enterprise workspace and an admin to publish it.
- No change management, problem or release tools.
Permissions
medium risk · 5 things to watch
Medium risk
The assistant can create and update tickets, assets, requests and articles with your permissions, and it is switched on for every account by default. Ask your admin to turn off the tools your team does not need, and set changes to need your approval in your AI app.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
On by default for every account
Any admin or agent can connect an AI tool unless an admin turns MCP off or limits it by role under Admin Settings, MCP. support.freshservice.com
It can create and change records
It can create and update tickets, assets and articles and file onboarding and offboarding requests. Turn off tools you do not need, or require approval for them. support.freshservice.com
API keys sit in a config file
The API key option stores your personal key in plain text in your client's config. Use sign-in instead where your client supports it. support.freshservice.com
Every call uses your allowance
Reads count the same as writes against the plan's action allowance, with 25 to 100 actions per minute by plan. support.freshservice.com
Changes are logged
Changes made through the assistant show in each record's activity history like any other change. support.freshservice.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No single read-only switch. A Freshservice admin can disable individual tools per MCP server configuration (Admin Settings > MCP), so turning off the create and update tools leaves read access. In Claude you can also set each tool to Needs approval or Blocked. |
|---|---|
| Talks to | Your Freshservice account (Freshworks). Your AI provider, through the assistant |
| Sign-in and keys | OAuth 2.0 sign-in (recommended), or each user's personal Freshservice API key in an Authorization header. |
Alternatives
Use the official server unless you need change management or ticket deletion, which only the community servers offer. Those run on your own computer with an API key.
| Server | Official | Runs | Sign-in | Can change things | GitHub stars |
|---|---|---|---|---|---|
| For Freshservice | |||||
| FreshserviceThis page | Official | Hosted | Account or API key | Yes | – |
| freshservice-mcp (fairgentur) | Community | Local | – | Yes | 4 |
| Other tools for the same job | |||||
| freshservice_mcp (effytech) | Community | Local | API key | Yes | – |
| node804-freshservice-mcp | Community | Local | – | Yes | – |
Questions
What is the Freshservice MCP server URL?
Each account has its own: https://<your-subdomain>.freshservice.com/mcp. Custom domains do not work, so use your freshservice.com address even if you normally use your own domain.
Which plans include it?
Growth, Pro and Enterprise, each with an included number of actions: 1,200, 6,000 or 12,000. You can buy more with an MCP Action Pack. Freshworks' pages disagree on whether that allowance is monthly or yearly, so check with your account manager.
Do read-only requests count against the allowance?
Yes, according to Freshworks' FAQ: any call counts as one action, read or write. Unused actions do not roll over.
Should I sign in or use an API key?
Sign in with your Freshservice account where your app supports it; Freshworks recommends it. Use your personal API key only for apps that cannot sign in. Employees (requesters) can only sign in.
Is it safe?
It acts as you, so it can only see and change what your Freshservice role allows, and changes show in each record's history. It can still create and update records, so turn off tools you do not need and set changes to need approval.
Can I make it read-only?
There is no single switch. An admin can turn off the create and update tools in the MCP settings, and in Claude you can set each tool to Needs approval or Blocked.
Can it delete tickets?
No. Freshworks lists no delete tools. Some community servers can delete tickets, if you need that.
Can employees use it, or only agents?
Freshworks documents a version for employees that covers their own tickets, the service catalog and knowledge base, with sign-in only. Its security page still says only admins and agents can use it, so ask your admin.
Does it work with ChatGPT?
Yes, on ChatGPT Enterprise. A workspace admin creates and publishes a Freshservice plugin first, then each user signs in.
How do I turn it off or revoke access?
Admins can turn it off or limit it by role under Admin Settings, MCP. To revoke one app, open your Profile settings, Modify Personal Information, Manage Third-party Apps, and click Revoke.
Examples
Check your ticket queue
Get all open tickets assigned to me.
SourceAdd an internal note to a ticket
Add an internal note to ticket 1023: 'The issue is caused by a sudden router reboot.'
SourceRequest software for someone
Request a software installation for Zoom for john@acme.com.
SourceFind knowledge base answers
Find solution articles for 'VPN issue'.
Source
Information
updated Nov 1, 2026
- Publisher
- Official
- Transport
- Streamable HTTP
- Auth
- OAuth
Other Freshservice MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 8Hide
- Model Context Protocol (MCP) integration in Freshservice · support.freshservice.com
- MCP Integration in Freshservice for Requesters · support.freshservice.com
- Set up a Freshservice data store · docs.cloud.google.com
- MCP Integration: FAQs · support.freshservice.com
- Freshworks MCP security · support.freshservice.com
- effytech/freshservice_mcp · github.com
- fairgentur/freshservice-mcp · github.com
- node804-freshservice-mcp · github.com