freshdesk mcp

Local 2025-09-01 00:36:02 0

Integrate AI models with Freshdesk to automate support operations. Create, update, and manage support tickets seamlessly through the Freshdesk API. Enhance your customer support experience with automated ticket management and AI-driven interactions.


smithery badge

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:

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

Prerequisites

  • A Freshdesk account (sign up at 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:
"mcpServers": {
  "freshdesk-mcp": {
    "command": "uvx",
    "args": [
        "freshdesk-mcp"
    ],
    "env": {
      "FRESHDESK_API_KEY": "<YOUR_FRESHDESK_API_KEY>",
      "FRESHDESK_DOMAIN": "<YOUR_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:

uvx freshdesk-mcp --env FRESHDESK_API_KEY=<your_api_key> --env FRESHDESK_DOMAIN=<your_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.

[
  {
    "description": "Get ticket fields from Freshdesk.",
    "inputSchema": {
      "properties": {},
      "title": "get_ticket_fieldsArguments",
      "type": "object"
    },
    "name": "get_ticket_fields"
  },
  {
    "description": "Get tickets from Freshdesk with pagination support.",
    "inputSchema": {
      "properties": {
        "page": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": 1,
          "title": "Page"
        },
        "per_page": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": 30,
          "title": "Per Page"
        }
      },
      "title": "get_ticketsArguments",
      "type": "object"
    },
    "name": "get_tickets"
  },
  {
    "description": "Create a ticket in Freshdesk",
    "inputSchema": {
      "properties": {
        "custom_fields": {
          "anyOf": [
            {
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": {
            "path": "smithery.yaml",
            "type": "blob"
          },
          "title": "Custom Fields"
        },
        "description": {
          "title": "Description",
          "type": "string"
        },
        "email": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": {
            "path": "smithery.yaml",
            "type": "blob"
          },
          "title": "Email"
        },
        "priority": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "string"
            }
          ],
          "title": "Priority"
        },
        "requester_id": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": {
            "path": "smithery.yaml",
            "type": "blob"
          },
          "title": "Requester Id"
        },
        "source": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "string"
            }
          ],
          "title": "Source"
        },
        "status": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "string"
            }
          ],
          "title": "Status"
        },
        "subject": {
          "title": "Subject",
          "type": "string"
        }
      },
      "required": [
        "subject",
        "description",
        "source",
        "priority",
        "status"
      ],
      "title": "create_ticketArguments",
      "type": "object"
    },
    "name": "create_ticket"
  },
  {
    "description": "Update a ticket in Freshdesk.",
    "inputSchema": {
      "properties": {
        "ticket_fields": {
          "title": "Ticket Fields",
          "type": "object"
        },
        "ticket_id": {
          "title": "Ticket Id",
          "type": "integer"
        }
      },
      "required": [
        "ticket_id",
        "ticket_fields"
      ],
      "title": "update_ticketArguments",
      "type": "object"
    },
    "name": "update_ticket"
  },
  {
    "description": "Delete a ticket in Freshdesk.",
    "inputSchema": {
      "properties": {
        "ticket_id": {
          "title": "Ticket Id",
          "type": "integer"
        }
      },
      "required": [
        "ticket_id"
      ],
      "title": "delete_ticketArguments",
      "type": "object"
    },
    "name": "delete_ticket"
  },
  {
    "description": "Get a ticket in Freshdesk.",
    "inputSchema": {
      "properties": {
        "ticket_id": {
          "title": "Ticket Id",
          "type": "integer"
        }
      },
      "required": [
        "ticket_id"
      ],
      "title": "get_ticketArguments",
      "type": "object"
    },
    "name": "get_ticket"
  },
  {
    "description": "Search for tickets in Freshdesk.",
    "inputSchema": {
      "properties": {
        "query": {
          "title": "Query",
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "title": "search_ticketsArguments",
      "type": "object"
    },
    "name": "search_tickets"
  },
  {
    "description": "Get a ticket conversation in Freshdesk.",
    "inputSchema": {
      "properties": {
        "ticket_id": {
          "title": "Ticket Id",
          "type": "integer"
        }
      },
      "required": [
        "ticket_id"
      ],
      "title": "get_ticket_conversationArguments",
      "type": "object"
    },
    "name": "get_ticket_conversation"
  },
  {
    "description": "Create a reply to a ticket in Freshdesk.",
    "inputSchema": {
      "properties": {
        "body": {
          "title": "Body",
          "type": "string"
        },
        "ticket_id": {
          "title": "Ticket Id",
          "type": "integer"
        }
      },
      "required": [
        "ticket_id",
        "body"
      ],
      "title": "create_ticket_replyArguments",
      "type": "object"
    },
    "name": "create_ticket_reply"
  },
  {
    "description": "Create a note for a ticket in Freshdesk.",
    "inputSchema": {
      "properties": {
        "body": {
          "title": "Body",
          "type": "string"
        },
        "ticket_id": {
          "title": "Ticket Id",
          "type": "integer"
        }
      },
      "required": [
        "ticket_id",
        "body"
      ],
      "title": "create_ticket_noteArguments",
      "type": "object"
    },
    "name": "create_ticket_note"
  },
  {
    "description": "Update a conversation for a ticket in Freshdesk.",
    "inputSchema": {
      "properties": {
        "body": {
          "title": "Body",
          "type": "string"
        },
        "conversation_id": {
          "title": "Conversation Id",
          "type": "integer"
        }
      },
      "required": [
        "conversation_id",
        "body"
      ],
      "title": "update_ticket_conversationArguments",
      "type": "object"
    },
    "name": "update_ticket_conversation"
  },
  {
    "description": "Get all agents in Freshdesk with pagination support.",
    "inputSchema": {
      "properties": {
        "page": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": 1,
          "title": "Page"
        },
        "per_page": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": 30,
          "title": "Per Page"
        }
      },
      "title": "get_agentsArguments",
      "type": "object"
    },
    "name": "get_agents"
  },
  {
    "description": "List all contacts in Freshdesk with pagination support.",
    "inputSchema": {
      "properties": {
        "page": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": 1,
          "title": "Page"
        },
        "per_page": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": 30,
          "title": "Per Page"
        }
      },
      "title": "list_contactsArguments",
      "type": "object"
    },
    "name": "list_contacts"
  },
  {
    "description": "Get a contact in Freshdesk.",
    "inputSchema": {
      "properties": {
        "contact_id": {
          "title": "Contact Id",
          "type": "integer"
        }
      },
      "required": [
        "contact_id"
      ],
      "title": "get_contactArguments",
      "type": "object"
    },
    "name": "get_contact"
  },
  {
    "description": "Search for contacts in Freshdesk.",
    "inputSchema": {
      "properties": {
        "query": {
          "title": "Query",
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "title": "search_contactsArguments",
      "type": "object"
    },
    "name": "search_contacts"
  },
  {
    "description": "Update a contact in Freshdesk.",
    "inputSchema": {
      "properties": {
        "contact_fields": {
          "title": "Contact Fields",
          "type": "object"
        },
        "contact_id": {
          "title": "Contact Id",
          "type": "integer"
        }
      },
      "required": [
        "contact_id",
        "contact_fields"
      ],
      "title": "update_contactArguments",
      "type": "object"
    },
    "name": "update_contact"
  },
  {
    "description": "List all canned responses in Freshdesk.",
    "inputSchema": {
      "properties": {
        "folder_id": {
          "title": "Folder Id",
          "type": "integer"
        }
      },
      "required": [
        "folder_id"
      ],
      "title": "list_canned_responsesArguments",
      "type": "object"
    },
    "name": "list_canned_responses"
  },
  {
    "description": "List all canned response folders in Freshdesk.",
    "inputSchema": {
      "properties": {},
      "title": "list_canned_response_foldersArguments",
      "type": "object"
    },
    "name": "list_canned_response_folders"
  },
  {
    "description": "List all solution articles in Freshdesk.",
    "inputSchema": {
      "properties": {
        "folder_id": {
          "title": "Folder Id",
          "type": "integer"
        }
      },
      "required": [
        "folder_id"
      ],
      "title": "list_solution_articlesArguments",
      "type": "object"
    },
    "name": "list_solution_articles"
  },
  {
    "description": "",
    "inputSchema": {
      "properties": {
        "category_id": {
          "title": "Category Id",
          "type": "integer"
        }
      },
      "required": [
        "category_id"
      ],
      "title": "list_solution_foldersArguments",
      "type": "object"
    },
    "name": "list_solution_folders"
  },
  {
    "description": "List all solution categories in Freshdesk.",
    "inputSchema": {
      "properties": {},
      "title": "list_solution_categoriesArguments",
      "type": "object"
    },
    "name": "list_solution_categories"
  },
  {
    "description": "View an agent in Freshdesk.",
    "inputSchema": {
      "properties": {
        "agent_id": {
          "title": "Agent Id",
          "type": "integer"
        }
      },
      "required": [
        "agent_id"
      ],
      "title": "view_agentArguments",
      "type": "object"
    },
    "name": "view_agent"
  },
  {
    "description": "Create an agent in Freshdesk.",
    "inputSchema": {
      "properties": {
        "agent_fields": {
          "title": "Agent Fields",
          "type": "object"
        }
      },
      "required": [
        "agent_fields"
      ],
      "title": "create_agentArguments",
      "type": "object"
    },
    "name": "create_agent"
  },
  {
    "description": "Update an agent in Freshdesk.",
    "inputSchema": {
      "properties": {
        "agent_fields": {
          "title": "Agent Fields",
          "type": "object"
        },
        "agent_id": {
          "title": "Agent Id",
          "type": "integer"
        }
      },
      "required": [
        "agent_id",
        "agent_fields"
      ],
      "title": "update_agentArguments",
      "type": "object"
    },
    "name": "update_agent"
  },
  {
    "description": "Search for agents in Freshdesk.",
    "inputSchema": {
      "properties": {
        "query": {
          "title": "Query",
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "title": "search_agentsArguments",
      "type": "object"
    },
    "name": "search_agents"
  }
]