Freescout MCP Server
FreeScout helpdesk ticket management for AI-driven issue analysis and response drafting.
Data last scanned today · Reviewed today
Overview
This server integrates directly with your FreeScout instance to enable AI-assisted helpdesk workflows. It provides specialized tools for fetching, analyzing, and updating support tickets, helping teams automate the identification of root causes and the generation of customer replies. The server features advanced search capabilities with support for relative time filters like "7d" or "24h" and pagination. It is built on the modern MCP SDK, utilizing Zod schema validation to ensure structured, reliable outputs for every ticket interaction.
Our verdict
With a security score of 35/100, this server is classified as high-risk. The primary concern is that it lacks a read-only mode, meaning every installation is granted full write access to your helpdesk data by default. Additionally, it is a community-maintained project rather than an official vendor release. It is suitable for testing or internal environments where full API write access is intentionally desired, but it should be avoided in sensitive production environments until further security reviews are performed.
- Supports relative time parameters for advanced ticket searching.
- Implements automatic retry logic with exponential backoff.
- Maintains structured type safety through Zod schema validation.
- Uses a compact codebase with only three direct dependencies.
- Lacks a dedicated read-only operational mode.
- No OAuth support detected for authentication.
- Community-maintained project without official vendor backing.
Setup
{
"mcpServers": {
"mcp-freescout": {
"args": [
"-y",
"@verygoodplugins/mcp-freescout"
],
"command": "npx"
}
}
}Paste into .cursor/mcp.json (project) or ~/.cursor/mcp.json (global), then reload Cursor. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Tools
| Tool | Description | Risk |
|---|---|---|
| freescout_get_ticket | Fetch a FreeScout ticket with all its details and conversation threads. | low |
| freescout_analyze_ticket | Analyze a ticket to determine issue type, root cause, and suggested solutions. | low |
| freescout_add_note | Add an internal note to a ticket for team communication. | medium |
| freescout_update_ticket | Update ticket status and/or assignment. | medium |
| freescout_create_draft_reply | Create a draft reply in FreeScout that can be edited before sending. | medium |
| freescout_get_ticket_context | Get ticket context and customer information to help craft personalized replies. | low |
| freescout_search_tickets | Search for tickets across your FreeScout instance. | low |
| freescout_get_mailboxes | Get a list of all available mailboxes in your FreeScout instance. | low |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf | ||||
| ChatGPT |
Frequently asked questions
›What are the system requirements to run the FreeScout MCP server?
You need Node.js 18 or higher and a FreeScout instance with API access enabled.
›Can I use relative time formats when filtering tickets?
Yes, the advanced search features support relative time strings such as 7d, 24h, and 30m for date filters.
›How does the server handle network errors or rate limits?
The server includes built-in reliability features that perform automatic retries using exponential backoff when it encounters transient failures.
›Are Git or GitHub integration tools available in the latest version?
No, Git and GitHub tools were removed in v2.0; you should use dedicated Git MCP servers for those workflows instead.
›Does the server require specific environment variables?
Yes, you must configure the FREESCOUT_URL and FREESCOUT_API_KEY environment variables in your MCP client settings.
Badge
Maintain this server? Add the live badge to your README.