How to connect a Freshdesk MCP with Claude Code (4 steps)

Developers building support automations need live Freshdesk data: open tickets, SLA breach risk, customer contact history, conversation threads, and more.

Getting that data today means authenticating against the Freshdesk REST API, managing API keys per environment, and writing one-off scripts every time a new workflow needs a different slice of ticket data.

To help your developers query and update support tickets directly from the terminal, we'll show you how to connect Freshdesk with Merge Agent Handler's Freshdesk MCP server.

How it works

Merge Agent Handler connects Claude Code to the Freshdesk API through a single CLI setup.

You install the Merge CLI, authenticate once with your Merge Agent Handler account, and register the connection with one command. Agent Handler manages your Freshdesk credentials so you never store API keys locally or handle token rotation yourself.

Here's the command that registers the connection:

claude mcp add 
--transport http agent-handler https://ah-api.merge.dev/mcp

Prerequisites

Before getting started, you'll need the following:

• A Merge Agent Handler account
• Claude Code installed (run claude --version to confirm)
• pipx installed (run pipx --version to confirm, or install via pip install pipx)
• A Freshdesk account with admin access to authenticate the connector

If you want to connect Merge Agent Handler's Freshdesk MCP with internal or customer-facing agentic products, you can follow the steps in our docs.

1. Install the Merge CLI

Run the following to install the Merge CLI: pipx install merge-api

Then verify the installation: merge --version

Related: How to use a ServiceNow MCP in Claude Code

2. Configure the CLI and log in

Run the interactive setup: merge configure

This prompts you for your Merge API key and sets your default workspace preferences, linking the CLI to your Merge Agent Handler account.

Then log in: merge login

Once you log in, the CLI can make authorized API requests on your behalf.

3. Add Agent Handler to Claude Code

Register the Agent Handler MCP server with Claude Code:

claude mcp add 
--transport http agent-handler https://ah-api.merge.dev/mcp

Verify the connection registered. Open Claude Code and run: /mcp. agent-handler should appear under Local MCPs with a connected status.

4. Authenticate Freshdesk

Select agent-handler from the MCP list. This opens a browser window where you select which integrations to authenticate. Choose Freshdesk and complete the OAuth flow, signing in with the account that has admin access to the tickets and customer data you want Claude Code to reach.

The first time you use a Freshdesk tool in a Claude Code session, a Magic Link may appear to complete connector authentication, as shown below.

Once authenticated, Merge stores and manages the token. You won't need to re-authenticate unless you revoke access.

To confirm the connector is accessible, open a Claude Code session and run a command like "List all open tickets with urgent or high priority that haven't been updated in the last 24 hours. Show the status, assigned agent, and customer name for each one."

You should then see an output like the following:

{{this-blog-only-cta}}

Freshdesk MCP FAQ

In case you have more questions on setting up and using the Freshdesk MCP in Claude Code, we've addressed several more commonly-asked questions below.

What can you do once the Freshdesk MCP is connected to Claude Code?

With Freshdesk connected, Claude Code can:

• Query and filter tickets: retrieve open, pending, or resolved tickets filtered by priority, status, group, or agent without opening the Freshdesk UI or exporting a report

• Read conversation threads: pull the full comment history on a ticket to give an agent the context it needs before drafting a reply or escalation note

• Look up contacts and companies: surface customer contact records and company details linked to a ticket, useful when an agent needs to apply custom SLA rules or route by account tier

• Create and update tickets: log new support requests, change ticket status, reassign to a different agent or group, and add notes directly from the terminal if write tools are enabled

• Check SLA compliance: identify tickets approaching or past their response and resolution deadlines, useful for agents that need to triage by urgency before a breach occurs

• Search the knowledge base: retrieve help articles relevant to an active ticket, useful when an agent needs to surface a resolution path or draft a response grounded in existing documentation

Why use Merge Agent Handler vs. a self-hosted Freshdesk MCP server?

You can build a self-hosted MCP server that calls the Freshdesk API directly. For a solo developer with a single Freshdesk account and a narrow set of tools, the setup is manageable: generate an API key, write tool schemas for the endpoints you need, and wire them to Claude Code.

The problem is maintenance and scale. Freshdesk's API surface covers tickets, contacts, companies, agents, groups, conversations, and SLA policies. A self-hosted setup means you own the schema for every tool you expose, and you're responsible for keeping those schemas current as your Freshdesk configuration changes. API key rotation, subdomain-specific endpoint management, and schema drift are all yours to handle.

At team scale, the credential problem compounds.

Each developer managing a separate API key means no central control over which Freshdesk operations each agent can perform, no audit trail of what was queried or written, and no way to scope a read-only triage agent away from write operations. If a key is rotated or an account is deprovisioned, every local setup that depends on it breaks silently.

Merge Agent Handler adds a control layer at the tool level.

You can define exactly which Freshdesk operations get exposed to an agent so it can be built for ticket triage and never gets access to bulk deletion or contact export. And  every tool call can be logged with the tool name, inputs, and response metadata.

Why connect Freshdesk to Claude Code?

Freshdesk holds the operational record of what your customers are experiencing: which issues are open, which tickets are breaching SLA, which customers are escalating, etc. Developers building support automations need that data as an input to larger workflows, and right now getting it requires a browser, a custom report, or a one-off REST call.

With the Freshdesk MCP connected, Claude Code can retrieve ticket queues, surface customer context, and check SLA status without a context switch.

This matters most when Freshdesk data drives a downstream action: routing a high-priority ticket before a breach, generating a daily summary of unresolved issues by product area, or drafting a reply grounded in the customer's full conversation history. The terminal becomes the place where support data and code execution meet, and agents that need both can get both in one session.