Freshdesk MCP server

The Freshdesk MCP Server is an implementation of the Model Context Protocol that integrates with Freshdesk. It allows AI models to interact directly with the Freshdesk platform to manage tickets, contacts, agents, and companies, essentially enabling automated support operations through AI assistance.

Features

• Freshdesk Integration: Seamless interaction with Freshdesk API endpoints
• AI Model Support: Enables AI models to perform support operations through Freshdesk
• Automated Ticket Management: Handle ticket creation, updates, and responses

Installation

Using Smithery

The simplest way to install the Freshdesk MCP server is via Smithery:

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

Prerequisites

Before installation, make sure you have:

• A Freshdesk account (sign up at freshdesk.com)
• Freshdesk API key
• uvx installed on your system

To install uvx:

pip install uv
# or
brew install uv

Configuration

Setting Up Claude Desktop

1. Make sure Claude Desktop is installed
2. Add the following configuration to your claude_desktop_config.json:

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

Configuration Parameters

• Replace <YOUR_FRESHDESK_API_KEY> with your actual Freshdesk API key
• Replace <YOUR_FRESHDESK_DOMAIN> with your Freshdesk domain (e.g., yourcompany.freshdesk.com)

Using the MCP Server

Manual Start

For testing purposes, you can start the server manually:

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

Available Tools

The server provides numerous tools for interacting with Freshdesk:

Ticket Management

• Create Ticket: Create new support tickets with details like subject, description, priority, etc.
• Update Ticket: Modify existing tickets
• Delete Ticket: Remove tickets
• Search Tickets: Find tickets using search criteria
• Get Ticket Details: Retrieve information about specific tickets
• Manage Ticket Conversations: Reply to tickets, add notes, update conversations
• Ticket Summary Management: View, update, or delete ticket summaries

Contact Management

• List Contacts: Get all contacts
• Get Contact: Retrieve a specific contact
• Search Contacts: Find contacts based on search criteria
• Update Contact: Modify contact information

Agent Management

• Get Agents: List all agents
• View Agent: Get details for a specific agent
• Create/Update Agents: Add new agents or modify existing ones
• Search Agents: Find agents based on criteria

Company Management

• List Companies: Get all companies
• View Company: Get details for a specific company
• Search Companies: Find companies based on criteria
• Find Company by Name: Locate a company using its name
• List Company Fields: Get all available company fields

Example Usage

Once configured, you can ask Claude to perform operations like:

• "Create a new ticket with subject 'Payment Issue for customer A101' and description as 'Reaching out for a payment issue in the last month for customer A101', where customer email is [email protected] and set priority to high"
• "Update the status of ticket #12345 to 'Resolved'"
• "List all high-priority tickets assigned to the agent John Doe"
• "List previous tickets of customer A101 in last 30 days"

Troubleshooting

If you encounter issues:

• Verify your Freshdesk API key and domain are correct
• Ensure proper network connectivity to Freshdesk servers
• Check API rate limits and quotas
• Verify the uvx command is available in your PATH

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.