Freshdesk

You deploy this Freshdesk MCP Server to let AI models interact with Freshdesk modules, enabling automated ticket management and agent-assisted support through a clean, MCP-backed interface.

How to use

You connect your MCP client to the Freshdesk MCP Server using the provided stdio configuration. Run the server locally and point your client to start it as a local process. Once running, you can perform common support operations through natural language prompts, such as creating tickets, updating tickets, replying to conversations, and querying tickets, agents, contacts, companies, and related fields. Use the available actions to manage tickets and extract summaries, notes, and conversations as needed.

Practical usage examples include asking the system to create a new ticket with a specific subject and description, updating the status of an existing ticket, listing high-priority tickets, or retrieving previous tickets for a customer. The server exposes a broad set of tools to cover core Freshdesk workflows, from ticket creation and updates to agent and contact management.

How to install

Prerequisites you need before installation are a Freshdesk account with an API key, a Freshdesk domain, and the uvx runtime installed on your system.

Install the Freshdesk MCP Server using the automated installer for Claude Desktop integration.

npx -y @smithery/cli install @effytech/freshdesk_mcp --client claude

Configure Claude Desktop to run the MCP server

Configure Claude Desktop to start the Freshdesk MCP Server via the stdio launcher. Place the following configuration in your Claude Desktop configuration so Claude can launch the MCP server and pass credentials.

"mcpServers": {
  "freshdesk_mcp": {
    "command": "uvx",
    "args": [
      "freshdesk-mcp"
    ],
    "env": {
      "FRESHDESK_API_KEY": "<YOUR_FRESHDESK_API_KEY>",
      "FRESHDESK_DOMAIN": "<YOUR_FRESHDESK_DOMAIN>"
    }
  }
}

Starting and testing the server locally

Start the MCP server locally using the runtime you installed. The example uses uvx to run the Freshdesk MCP locally with your API key and domain.

uvx freshdesk-mcp --env FRESHDESK_API_KEY=<your_api_key> --env FRESHDESK_DOMAIN=<your_domain>

Available tools

create_ticket

Create new support tickets with a subject, description, and optional fields such as requester details, custom fields, and additional fields.

update_ticket

Update fields on an existing ticket identified by ticket_id.

delete_ticket

Delete a ticket by its ticket_id.

search_tickets

Search tickets using a query string to filter results.

get_ticket_fields

Retrieve all available ticket fields.

get_tickets

Fetch a paginated list of tickets with optional page size.

get_ticket

Get details for a single ticket by ticket_id.

get_ticket_conversation

Retrieve the conversation history for a ticket.

create_ticket_reply

Post a reply to a ticket's conversation.

create_ticket_note

Add a note to a ticket.

update_ticket_conversation

Update content in a ticket conversation.

view_ticket_summary

Get the summary of a ticket.

update_ticket_summary

Update the summary field of a ticket.

delete_ticket_summary

Remove the summary from a ticket.

get_agents

List all support agents with pagination.

view_agent

Fetch details for a single agent.

create_agent

Create a new agent with the provided fields.

update_agent

Update details of an existing agent.

search_agents

Search for agents by query.

list_contacts

List contacts with optional pagination.

get_contact

Get a single contact by ID.

search_contacts

Search for contacts by query.

update_contact

Update fields on a contact.

list_companies

List companies with pagination.

view_company

Get details for a single company.

search_companies

Search for companies by query.

find_company_by_name

Find a company by its name.

list_company_fields

Get all company fields.