https://github.com/effytech/freshdesk_mcp
MCP server created for Freshdesk, allowing AI models to interact with Freshdesk modules
https://github.com/effytech/freshdesk_mcp
Last synced: 3 months ago
JSON representation
MCP server created for Freshdesk, allowing AI models to interact with Freshdesk modules
- Host: GitHub
- URL: https://github.com/effytech/freshdesk_mcp
- Owner: effytech
- License: mit
- Created: 2025-03-20T10:03:06.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-03-29T19:41:43.000Z (3 months ago)
- Last Synced: 2025-03-29T20:27:06.011Z (3 months ago)
- Language: Python
- Size: 44.9 KB
- Stars: 0
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - effytech/freshdesk-mcp - An MCP server that integrates with Freshdesk, enabling AI models to interact with Freshdesk modules and perform various support operations. ([Read more](/details/effytechfreshdesk-mcp.md)) `mcp` `customer-support` `api-integration` `open-source` (Business & Commerce MCP Servers)
- awesome-devops-mcp-servers - effytech/freshdesk-mcp - MCP server that integrates with Freshdesk, enabling AI models to interact with Freshdesk modules and perform various support operations. (Project & Service Management / 🎫 Ticketing Systems)
- awesome-devops-mcp-servers - effytech/freshdesk-mcp - MCP server that integrates with Freshdesk, enabling AI models to interact with Freshdesk modules and perform various support operations. (Project & Service Management / 🎫 Ticketing Systems)
- awesome-mcp-servers - Freshdesk AI Agent - MCP server created for Freshdesk, allowing AI models to interact with Freshdesk modules (Table of Contents / AI Services)
- awesome-mcp-servers - Freshdesk AI Agent - MCP server created for Freshdesk, allowing AI models to interact with Freshdesk modules (Table of Contents / AI Services)
- mcp-index - Freshdesk Integration Server - Integrate AI models with Freshdesk to automate support operations, facilitating the creation, update, and management of support tickets through the Freshdesk API. Enhance customer support interactions with automated ticket handling and AI-driven responses. (APIs and HTTP Requests)
- awesome-mcp-registry - ❌ freshdesk-mcp - driven interactions. (python) (Support & Service Management)
- awesome-mcp-registry - ❌ freshdesk-mcp - driven interactions. (python) (Support & Service Management)
README
# Freshdesk MCP Server
[](https://smithery.ai/server/@effytech/freshdesk_mcp)
An MCP server implementation that integrates with Freshdesk, enabling AI models to interact with Freshdesk modules and perform various support operations.
## 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
## Components
### Tools
The server offers several tools for Freshdesk operations:
- `create_ticket`: Create new support tickets
- **Inputs**:
- `subject` (string, required): Ticket subject
- `description` (string, required): Ticket description
- `source` (number, required): Ticket source code
- `priority` (number, required): Ticket priority level
- `status` (number, required): Ticket status code
- `email` (string, optional): Email of the requester
- `requester_id` (number, optional): ID of the requester
- `custom_fields` (object, optional): Custom fields to set on the ticket
- `update_ticket`: Update existing tickets
- **Inputs**:
- `ticket_id` (number, required): ID of the ticket to update
- `updates` (object, required): Fields to update
- `delete_ticket`: Delete a ticket
- **Inputs**:
- `ticket_id` (number, required): ID of the ticket to delete
- `search_tickets`: Search for tickets based on criteria
- **Inputs**:
- `query` (string, required): Search query string
- `get_ticket_fields`: Get all ticket fields
- **Inputs**:
- None
- `get_tickets`: Get all tickets
- **Inputs**:
- `page` (number, optional): Page number to fetch
- `per_page` (number, optional): Number of tickets per page
- `get_ticket`: Get a single ticket
- **Inputs**:
- `ticket_id` (number, required): ID of the ticket to get
## Getting Started
### Installing via Smithery
To install freshdesk_mcp for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@effytech/freshdesk_mcp):
```bash
npx -y @smithery/cli install @effytech/freshdesk_mcp --client claude
```
### Prerequisites
- A Freshdesk account (sign up at [freshdesk.com](https://freshdesk.com))
- Freshdesk API key
- `uvx` installed (`pip install uv` or `brew install uv`)
### Configuration
1. Generate your Freshdesk API key from the Freshdesk admin panel
2. Set up your domain and authentication details
### Usage with Claude Desktop
1. Install Claude Desktop if you haven't already
2. Add the following configuration to your `claude_desktop_config.json`:
```json
"mcpServers": {
"freshdesk-mcp": {
"command": "uvx",
"args": [
"freshdesk-mcp"
],
"env": {
"FRESHDESK_API_KEY": "",
"FRESHDESK_DOMAIN": ""
}
}
}
```
**Important Notes**:
- Replace `YOUR_FRESHDESK_API_KEY` with your actual Freshdesk API key
- Replace `YOUR_FRESHDESK_DOMAIN` with your Freshdesk domain (e.g., `yourcompany.freshdesk.com`)
## Example Operations
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"
## Testing
For testing purposes, you can start the server manually:
```bash
uvx freshdesk-mcp --env FRESHDESK_API_KEY= --env FRESHDESK_DOMAIN=
```
## Troubleshooting
- 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
## License
This MCP server is licensed under the MIT License. See the LICENSE file in the project repository for full details.