MCP FreeScout — Claude Code MCP server: features and setup
Connect an AI agent to FreeScout to inspect and classify tickets, update their status, and save reply drafts. Requires Node.js 24 or newer and FreeScout API access.
claude mcp add --env FREESCOUT_URL=<FREESCOUT_URL> --env FREESCOUT_API_KEY=<FREESCOUT_API_KEY> --env FREESCOUT_DEFAULT_USER_ID=<FREESCOUT_DEFAULT_USER_ID> --transport stdio mcp-freescout -- npx -y @verygoodplugins/mcp-freescoutWhat MCP FreeScout does
MCP FreeScout gives an agent tools to retrieve ticket details and conversation threads, classify an issue, and assess its likely cause. It can also add an internal note, change a ticket’s status or assignment, and save a reply draft. Markdown in the draft is converted to HTML for FreeScout.
The server runs over stdio and can be launched through npx. You’ll need Node.js 24 or newer, a FreeScout instance with API access enabled, its URL, and an API key. Without API access to the instance, the server cannot read or update tickets.
What it helps with
- classify a ticket and assess its likely cause
- retrieve a conversation by ticket ID, number, or URL
- leave an internal note for the team
- change a ticket’s status or assigned user
- save a reply draft in FreeScout
Example prompts for the agent
- Inspect FreeScout ticket 12345 and identify the issue type and likely cause.
- Add an internal note to ticket 12345 saying the customer confirmed the fix works.
- Draft a response for ticket 12345 and save it for review before sending.
How to install MCP FreeScout
Platform CLI
claude mcp add --env FREESCOUT_URL=<FREESCOUT_URL> --env FREESCOUT_API_KEY=<FREESCOUT_API_KEY> --env FREESCOUT_DEFAULT_USER_ID=<FREESCOUT_DEFAULT_USER_ID> --transport stdio mcp-freescout -- npx -y @verygoodplugins/mcp-freescoutReplace <…> with your own values
Platform CLI
codex mcp add mcp-freescout --env FREESCOUT_URL=<FREESCOUT_URL> --env FREESCOUT_API_KEY=<FREESCOUT_API_KEY> --env FREESCOUT_DEFAULT_USER_ID=<FREESCOUT_DEFAULT_USER_ID> -- npx -y @verygoodplugins/mcp-freescoutReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp-freescout": {
"command": "npx",
"args": [
"-y",
"@verygoodplugins/mcp-freescout"
],
"env": {
"FREESCOUT_URL": "<FREESCOUT_URL>",
"FREESCOUT_API_KEY": "<FREESCOUT_API_KEY>",
"FREESCOUT_DEFAULT_USER_ID": "<FREESCOUT_DEFAULT_USER_ID>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp-freescout": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@verygoodplugins/mcp-freescout"
],
"env": {
"FREESCOUT_URL": "<FREESCOUT_URL>",
"FREESCOUT_API_KEY": "<FREESCOUT_API_KEY>",
"FREESCOUT_DEFAULT_USER_ID": "<FREESCOUT_DEFAULT_USER_ID>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e FREESCOUT_URL=<FREESCOUT_URL> -e FREESCOUT_API_KEY=<FREESCOUT_API_KEY> -e FREESCOUT_DEFAULT_USER_ID=<FREESCOUT_DEFAULT_USER_ID> mcp-freescout npx -y @verygoodplugins/mcp-freescoutReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about MCP FreeScout
How do I install MCP FreeScout in Claude Code?
Run claude mcp add mcp-freescout -e FREESCOUT_URL=<FREESCOUT_URL> -e FREESCOUT_API_KEY=<FREESCOUT_API_KEY> -- npx -y @verygoodplugins/mcp-freescout. Set the FreeScout URL and API key.
What does MCP FreeScout do?
It lets an agent retrieve and analyze FreeScout tickets, add internal notes, change ticket status or assignment, and save reply drafts.
What does MCP FreeScout need to run?
It requires Node.js 24 or newer and a FreeScout instance with API access enabled. Provide the instance URL and API key through environment variables.
