Freshdesk MCP, Freshworks' official MCP server
Lets your AI assistant read, create and reply to Freshdesk tickets, and look up contacts, companies and help articles.
This is Freshworks' own server, built into every Freshdesk account on the Growth, Pro and Enterprise plans. It lets Claude, Cursor or VS Code read and update tickets, reply to customers, and look up contacts, companies and help articles. You connect with your personal Freshdesk API key, and the assistant can only do what your Freshdesk role allows. Each tool call counts against a yearly allowance of actions on your plan, so heavy use can need an add-on pack.
Good for
- Support agents who want Claude to triage, summarise and reply to tickets
- Support leads who want a quick read on today's queue by status or priority
- Knowledge base editors drafting and updating help articles from real tickets
- Freshdesk admins setting up groups, agents and companies by asking in plain words
Works in
4 supported · 8 should work
Tap an app to see how to set it up and any known problems.
Freshdesk's docs cover it: add your account's address and your API key with one command. support.freshdesk.com
Freshdesk's docs cover it through a small bridge in the Claude config file, so Node.js must be installed. support.freshdesk.com
Freshdesk's docs cover it: add the address and your API key to .cursor/mcp.json. support.freshdesk.com
Freshdesk's docs cover it: add the address and API key to your user mcp.json, then press Start. support.freshdesk.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.
Client does not support this transport.
Install Freshdesk MCP
Claude Code
- 1
Copy this prompt.
Add the Freshdesk MCP server to Claude Code. Run this command: claude mcp add my-remote-server --transport http https://<subdomain>.freshdesk.com/mcp --header "Authorization: <api-key>" 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 Freshdesk Growth, Pro or Enterprise plan, Admin or agent role.
Read-only mode: No read-only switch. Connect with an API key from an agent whose Freshdesk role has only the permissions you want the assistant to have.
Find your API key in your Freshdesk profile settings; admins can copy the server address from Admin Settings > Apps & Integrations > MCP. Replace <subdomain> with your freshdesk.com subdomain; custom portal domains do not work here. The key goes in the header as-is, and everything the assistant does runs with your Freshdesk role. If the connection times out, your account or network may restrict IPs; Freshdesk's guide lists the ranges to allow per region.
From the vendor's docs. Source.
Tools
Finds tickets that match filters such as status, priority or assignee
Searches your tickets by criteria like status, priority, agent or dates, so you can find exactly the ones you need.
Try: “Show my open high-priority tickets”
Read ·
fetchSearchTicketsLists tickets in your help desk
Returns a list of tickets, for example everything created today, which the assistant can then group or summarise.
Try: “Get all tickets created today and group them by status”
Read ·
fetchTicketsOpens one ticket with its full details
Fetches a single ticket by its ID, with its subject, status, priority, requester and other fields.
Try: “What is the status of ticket 1001?”
Read ·
fetchTicketReads the full back-and-forth on a ticket
Pulls every reply and note on a ticket so the assistant can summarise the history or draft a response.
Try: “Summarise the conversation on ticket 1001”
Read ·
fetchTicketConversationsOpens a help article from your knowledge base
Fetches one knowledge base article with its content, so the assistant can quote or check it.
Try: “Show me the refund policy article”
Read ·
fetchSolutionArticleLists the help articles in a knowledge base folder
Returns every article inside one knowledge base folder.
Try: “List the articles in the Billing folder”
Read ·
fetchSolutionFolderArticlesLists the sections of your knowledge base
Returns the top-level categories of your Freshdesk knowledge base.
Try: “What categories does our help center have?”
Read ·
fetchSolutionCategoriesOpens one knowledge base section
Fetches the details of a single knowledge base category.
Try: “Show details of the Getting Started category”
Read ·
fetchSolutionCategoryLists the folders inside a knowledge base section
Returns the folders that sit inside one knowledge base category.
Try: “Which folders are in the Account category?”
Read ·
fetchSolutionCategoryFoldersOpens one knowledge base folder
Fetches the details of a single knowledge base folder.
Try: “Show the details of the Payments folder”
Read ·
fetchSolutionFolderFinds a customer contact by name
Looks up contacts whose name matches what you type, useful before creating or updating a ticket for them.
Try: “Find the contact named Sarah Lee”
Read ·
fetchContactAutocompleteLists your customer contacts
Returns a list of contacts in your Freshdesk account.
Try: “List contacts added this week”
Read ·
fetchContactsOpens one customer's contact record
Fetches a single contact with their email, phone, company and other details.
Try: “Show the contact details for John Doe”
Read ·
fetchContactFinds a customer company by name
Looks up companies whose name matches what you type.
Try: “Find the company Acme”
Read ·
fetchCompanyAutocompleteFinds companies by your custom company fields
Searches companies using the custom fields your team has set up, such as plan or region.
Try: “Find companies on the Enterprise tier”
Read ·
fetchSearchCompaniesOpens one company record
Fetches a single company with its details and fields.
Try: “Show the record for Acme Corp”
Read ·
fetchCompanyLists the agents on your support team
Returns the agents in your Freshdesk account.
Try: “Who are the agents on our team?”
Read ·
fetchAgentsOpens one agent's profile
Fetches the details of a single support agent.
Try: “Show the profile for agent Priya”
Read ·
fetchAgentLists your support groups
Returns the agent groups set up in Freshdesk.
Try: “List all support groups”
Read ·
fetchGroupsOpens one support group and its members
Fetches a single group's details, including who is in it.
Try: “Show me the members of the Network Team group”
Read ·
fetchGroupCreates a new support ticket
Opens a new ticket with the subject, requester, priority and other fields you give it.
Try: “Create a high-priority ticket for a payment issue from Sarah”
Write ·
createTicketSends a reply to the customer on a ticket
Posts a reply on a ticket, which Freshdesk sends to the customer like any agent reply.
Try: “Reply to ticket 1001 saying the refund was issued”
Write ·
replyTicketAdds a note to a ticket
Adds a note to a ticket's conversation, for example an internal update for your team.
Try: “Add a note to ticket 1001 that we are waiting on finance”
Write ·
createTicketNoteChanges a ticket's status, priority, assignee or other fields
Edits an existing ticket, such as closing it, raising its priority or assigning it to someone.
Try: “Set ticket 1001 to resolved”
Write ·
updateTicketAdds a message to an existing ticket conversation
Adds a new message to a conversation that is already on a ticket.
Try: “Add a message to the latest conversation on ticket 1001 saying we are still checking”
Write ·
updateConversationUpdates many tickets at once
Applies the same change, such as a status or group, to a set of tickets in one go.
Try: “Move all open billing tickets to the Finance group”
Write ·
createTicketBulkUpdateAdds a new customer contact
Creates a contact record with the name, email and other details you give it.
Try: “Create a contact for John Doe with the email johndoe@acme-corp.com”
Write ·
createContactAdds a new customer company
Creates a company record in Freshdesk.
Try: “Create a company named Acme Corp”
Write ·
createCompanyChanges a company's details
Edits an existing company record, such as its name or custom fields.
Try: “Update the company name for record 11 to Apple”
Write ·
updateCompanyWrites a new help article in a knowledge base folder
Creates a new knowledge base article inside a folder you choose.
Try: “Write a help article on resetting passwords in the Account folder”
Write ·
createSolutionFolderArticleEdits an existing help article
Changes the content or details of a knowledge base article.
Try: “Update the refund article with the new 30-day window”
Write ·
updateSolutionArticleAdds a folder to a knowledge base section
Creates a new folder inside a knowledge base category.
Try: “Create a Shipping folder in the Orders category”
Write ·
createSolutionCategoryFolderAdds a new section to your knowledge base
Creates a new top-level knowledge base category.
Try: “Create a knowledge base category called Integrations”
Write ·
createSolutionCategoryCreates a new support group
Adds an agent group, for example for a team or region.
Try: “Add a new support group called Network Team”
Write ·
createGroupChanges a support group's details or members
Edits an existing group, such as its name or who is in it.
Try: “Add Priya to the Network Team group”
Write ·
updateGroupAdds a new agent to your help desk
Creates a support agent account; works only if your Freshdesk role can manage agents.
Try: “Add Maria as a new support agent”
Write ·
createAgentChanges an agent's details or role
Edits an existing agent, such as their role or groups; works only if your Freshdesk role can manage agents.
Try: “Change Priya's role to supervisor”
Write ·
updateAgent
From the official docs
Pros and cons
Good
- Made and run by Freshworks, with nothing to install for Claude Code, Cursor or VS Code.
- Covers tickets, replies, notes, contacts, agents, groups, companies and help articles.
- Uses your own Freshdesk role, so it cannot see or do more than you can.
- Changes appear in Freshdesk's activity history.
- Long lists come back in pages on their own, so big results do not overflow the chat.
- No delete tools, so it cannot remove tickets or contacts.
Watch out
- API key only; there is no sign-in with your Freshdesk account.
- No read-only mode and no way to turn off single tools.
- Every tool call counts against a yearly action allowance, as low as 1,200 on Growth.
- Only on Growth, Pro and Enterprise, and not on Freshdesk versions older than Standalone 2021.
- Custom portal domains do not work; you must use your freshdesk.com address.
- Claude Desktop needs Node.js for the bridge Freshdesk's guide uses.
Permissions
medium risk · 5 things to watch
Medium risk
The assistant can reply to customers, update many tickets at once, and change agents and groups if your key allows it. There is no read-only switch, so connect with an agent account whose role only has the permissions you need.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can reply to customers and bulk-update tickets
Write tools include replying on tickets and updating many tickets at once. Ask the assistant to show what it will change before it does it. support.freshdesk.com
You cannot turn off single tools
Every tool is available to anyone with a valid API key. Limit what works by connecting with an agent whose role has only the permissions needed. support.freshdesk.com
Agent and group changes follow your role
Creating or changing agents and groups works only if the key owner's Freshdesk role allows it. Use a key from a role without admin rights for everyday ticket work. support.freshdesk.com
Your API key sits in a config file
Keep the file private and rotate the key from time to time, as Freshworks advises. support.freshdesk.com
Changes show in Freshdesk's activity history
Actions made through the assistant are logged like API and UI changes, so you can trace what it did. support.freshdesk.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only switch or per-tool control. Access follows the Freshdesk role of the API key's owner, so a key from a role with fewer permissions is the only way to narrow it. |
|---|---|
| Sign-in and keys | Personal Freshdesk API key sent in the Authorization header and saved in the client's config file. |
| Data retention | Freshworks says the server keeps no copy or cache of your data; calls go straight to Freshdesk. |
Alternatives
Use Freshworks' own server if you are on Growth, Pro or Enterprise with a current Freshdesk version. The community servers are the fallback for older Freshdesk versions or when you want to avoid the action allowance.
| Server | Official | Runs | Sign-in | GitHub stars |
|---|---|---|---|---|
| For Freshdesk | ||||
| Freshdesk MCP ServerThis page | Official | Hosted | API key | – |
| Mindstone Freshdesk | Community | Local | – | – |
| freshdeck-mcp | Community | – | – | 12 |
| Other tools for the same job | ||||
| effytech freshdesk_mcp | Community | – | – | 71 |
Questions
Is the Freshdesk MCP server free?
It is included on the Growth, Pro and Enterprise plans, with a yearly allowance of 1,200, 6,000 or 12,000 actions. Every successful tool call is one action, whether it reads or writes. You can buy extra action packs as an add-on.
What is the Freshdesk MCP server URL?
https://<your-subdomain>.freshdesk.com/mcp. Custom portal domains do not work for it, so use your freshdesk.com address. Admins can copy it from Admin Settings > Apps & Integrations > MCP.
Can I sign in with my Freshdesk account instead of an API key?
No. Freshdesk only accepts your personal API key, which you find in your profile settings. Each person connects with their own key.
Which Freshdesk plans and versions does it work on?
Growth, Pro and Enterprise, on Freshdesk Standalone 2021 or Freshdesk Unified Omni 2026. Older Freshdesk versions lost access when the early access program ended in September 2026.
Is it safe to let an AI reply to customers?
It can only do what your Freshdesk role allows, and every change shows in the activity history. There is no read-only mode, so ask it to draft or show changes before it sends replies or updates tickets in bulk.
Can I turn off some tools?
Not yet. Every tool is available to anyone with a valid key. Connecting with an agent whose role has fewer permissions is the only way to limit it.
Can it delete tickets or contacts?
No. Freshdesk's tool list has no delete actions. It can create, update and reply.
What happens when I run out of actions?
Admins get alerts at 50, 75, 90, 95, 99 and 100 percent of the allowance. Unused actions do not roll over, and more can be bought as an add-on pack.
Why does the connection time out?
Usually IP restrictions on your Freshdesk account or company network. Freshdesk's guide lists the IP ranges to allow for each region, and outbound HTTPS must be open.
Is Freshdesk in Claude's connector directory?
No. You add the server address and your API key yourself, using the steps in the install box above.
Examples
Create a ticket from a customer report
Create a high-priority ticket for a payment issue from Sarah.
SourceSummarise today's ticket queue
Get all tickets created today and group them by status.
SourceTriage your own urgent tickets
Filter my assigned tickets for those with 'open' status and 'high' priority.
SourceFind a help article to answer a customer
Find the solution article for payment refunds.
SourceSet up a new support group
Add a new support group called 'Network Team'.
Source
Information
updated Nov 1, 2026
- Publisher
- Official
- Transport
- Streamable HTTP
- Auth
- API key
Other Freshdesk 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 4Hide
- Model Context Protocol (MCP) integration in Freshdesk · support.freshdesk.com
- Freshworks MCP security · support.freshdesk.com
- MCP Integration: Frequently asked questions · support.freshdesk.com
- effytech/freshdesk_mcp · github.com