PlugWiki

Freshdesk MCP, Freshworks' official MCP server

OfficialRemote

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.

Install Freshdesk MCP

Claude Code

  1. 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. 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 · fetchSearchTickets

  • Lists 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 · fetchTickets

  • Opens 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 · fetchTicket

  • Reads 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 · fetchTicketConversations

  • Opens 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 · fetchSolutionArticle

  • Lists 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 · fetchSolutionFolderArticles

  • Lists 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 · fetchSolutionCategories

  • Opens one knowledge base section

    Fetches the details of a single knowledge base category.

    Try: “Show details of the Getting Started category”

    Read · fetchSolutionCategory

  • Lists 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 · fetchSolutionCategoryFolders

  • Opens one knowledge base folder

    Fetches the details of a single knowledge base folder.

    Try: “Show the details of the Payments folder”

    Read · fetchSolutionFolder

  • Finds 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 · fetchContactAutocomplete

  • Lists your customer contacts

    Returns a list of contacts in your Freshdesk account.

    Try: “List contacts added this week”

    Read · fetchContacts

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-onlyNo 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 keysPersonal Freshdesk API key sent in the Authorization header and saved in the client's config file.
Data retentionFreshworks 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.

ServerOfficialRunsSign-inGitHub stars
For Freshdesk
Freshdesk MCP ServerThis pageOfficialHostedAPI key–
Mindstone FreshdeskCommunityLocal––
freshdeck-mcpCommunity––12
Other tools for the same job
effytech freshdesk_mcpCommunity––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.

    Source
  • Summarise today's ticket queue

    Get all tickets created today and group them by status.

    Source
  • Triage your own urgent tickets

    Filter my assigned tickets for those with 'open' status and 'high' priority.

    Source
  • Find a help article to answer a customer

    Find the solution article for payment refunds.

    Source
  • Set 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

DocsPricing

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 4
  1. Model Context Protocol (MCP) integration in Freshdesk · support.freshdesk.com
  2. Freshworks MCP security · support.freshdesk.com
  3. MCP Integration: Frequently asked questions · support.freshdesk.com
  4. effytech/freshdesk_mcp · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 1, 2026.