THIS IS AN ALPHA SERVER, STILL UNDER DEVELOPMENT

Freshdesk MCP Server

An MCP (Model Context Protocol) server that connects to the Freshdesk API, allowing LLMs to retrieve and search solution articles.

Features

• Retrieve all solution articles from Freshdesk
• Search for specific articles using the Freshdesk search API
• Browse categories and folders
• Get detailed article information

Prerequisites

• Node.js 18 or higher
• Freshdesk account with API access
• Freshdesk API key

Installation

1. Clone this repository
2. Install dependencies:

npm install

3. Create a .env file based on the .env.example file:

cp .env.example .env

4. Add your Freshdesk API key and domain to the .env file:

FD_KEY=your_freshdesk_api_key_here
FD_DOMAIN=your_freshdesk_domain_here

Building

Build the TypeScript code:

npm run build

Running

Start the MCP server:

npm start

Using with Claude Desktop

To use this MCP server with Claude Desktop, add the following to your claude_desktop_config.json file:

{
  "mcpServers": {
    "freshdesk": {
      "command": "npx",
      "args": ["@virtualgain/freshdeskmcp"],
      "env": {
        "FD_KEY": "your_freshdesk_api_key_here",
        "FD_DOMAIN": "your_freshdesk_domain_here"
      }
    }
  }
}

Available Resources

• freshdesk://articles - Get all solution articles
• freshdesk://article/{id} - Get a specific article by ID

Available Tools

• search-articles - Search for articles using a query string
• get-categories - Get all solution categories and their folders

Development

For development, you can run the server in watch mode:

npm run dev

License

MIT