What is the Herodesk MCP server?

Connect Claude, ChatGPT and other AI assistants to Herodesk, so they can read and work in your helpdesk with exactly your permissions.

Written by Anders Eiler
Last updated 2026-11-13
On this page

The Herodesk MCP server lets you connect an AI assistant such as Claude, ChatGPT, Grok or Cursor to your Herodesk workspace. Once connected, you can ask your assistant to work in your helpdesk in plain language: find conversations, summarize a customer's history, add notes, reply, tag and assign, write help center articles, or set up and test your AI agents.

MCP (Model Context Protocol) is an open standard that AI assistants use to talk to other systems. Herodesk runs its own MCP server at:

https://mcp.herodesk.io/mcp

What your assistant can do

  • See your helpdesk – search and read conversations across every channel, look up contacts and companies, and browse inboxes, tags, teams, users and smart views.
  • Work on conversations – reply to customers, add internal notes, assign, tag, change status, move to another inbox and create new outbound conversations.
  • Maintain your help center – write and update articles and FAQs, upload images and translate content into your other help center languages.
  • Manage your setup – quick replies, contacts and companies, and for managers and admins also tags, users, teams, SLA policies and webhooks.
  • Set up your AI agents (managers and admins) – create and duplicate agents, set their personality and where they answer, give them knowledge and skills, maintain topics and instructions, test them in the playground, track goals and fine-tune their replies.

See MCP examples: what you can ask your AI assistant for ready-to-use prompts.

How it works

  • You connect with your own Herodesk login. Every connection belongs to one user on one workspace. There are no shared API keys.
  • Your assistant has exactly your permissions. It inherits your role (agent, manager or admin) and your team inbox access. Conversations in inboxes you can't see in Herodesk are invisible to your assistant too, and tools your role can't use are hidden.
  • Everything goes through the Herodesk API. The same validation and permission checks apply as when you work in the app, and changes appear in the audit log under your name.
  • Your password stays with Herodesk. You sign in on Herodesk's own login page. The AI assistant only receives a token tied to your account, which you can revoke at any time.

Connect your assistant

Full, client-specific instructions are on mcp.herodesk.io. In short:

The mcp.herodesk.io page with the server URL and setup steps for Claude, Claude Code, ChatGPT and Grok

  1. Add the server to your AI client.
    • Claude (claude.ai and Claude Desktop): Settings → Connectors → Add custom connector, then paste the server URL.
    • Claude Code: run claude mcp add --transport http herodesk https://mcp.herodesk.io/mcp
    • ChatGPT: Settings → Connectors (developer mode) → add the server URL. Search and deep research are supported.
    • Grok: ask Grok to "Connect to the Herodesk MCP server at https://mcp.herodesk.io/mcp".
    • Cursor and other MCP clients: add it as an HTTP server with the URL above.
  2. Enter your workspace name. A browser window opens. Type the first part of your Herodesk address – for acme.app.herodesk.io that is acme – and click Continue.
  3. Sign in and approve. Sign in with your normal Herodesk login (including two-factor authentication if you use it). On the consent screen, check which permissions the assistant asks for and click Authorize.

The consent screen can show two permissions:

PermissionWhat it allows
ReadRead conversations, contacts, companies, inboxes, tags and users you have access to
WriteReply to conversations, add notes, update conversations and manage contacts on your behalf

Tip: if the consent screen only shows Read, your assistant can look things up but can't reply, tag or change anything. Reconnect if you need write access.

Important: replies your assistant sends are delivered to your customers immediately, in your name.

Which plans include MCP?

The MCP server is available on all Herodesk plans. Some tools follow the features of your plan – for example, companies, teams and SLA policies require the Pro plan, and help center tools require the Help Center feature. How many requests your assistant can make per minute also depends on your plan, see MCP security, permissions and limits.

See or disconnect your AI assistants

Go to Profile → Security. The Connected AI clients card lists every assistant you have connected, with the date it was connected. Click Revoke to disconnect one. Revoking takes effect on the assistant's next request.

The card only appears when you have at least one active connection. Connections are also removed automatically when you change or reset your password, and a connection that hasn't been used for 30 days expires – just connect again.

Next steps