FogBugz
About
A local MCP server for interacting with FogBugz issue tracker through LLM
Details
- Author
- todevelopers
- Categories
- Developer Tools, Project Management
Jump to
Setup
Install FogBugz in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/todevelopers/fogbugz-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
AModel Context Protocol (MCP)server that connects AI assistants to a liveFogBugzinstance. Search and manage cases, track history, assign and resolve — all from a natural language conversation. Works with on-premise and on-demand FogBugz installations.
- Search and list casesusing FogBugz query syntax (e.g.project:Website status:Active)
- Read case detailsincluding full event and comment history
- Create and update cases— set title, project, area, milestone, priority, and comments
- Full lifecycle management— assign, resolve, reopen, and close cases
- User, project, and area discovery— list people, categories, projects, milestones, and statuses
- Create new projectsdirectly from the conversation
- Automatic API selection— detects your FogBugz version and switches between XML and JSON API automatically
- FogBugz (on-premise or on-demand)
- Node.js 20 or later
- A FogBugz API token
You need an API token to authenticate the MCP server with FogBugz. There are two ways to obtain one:
Go toAccount & Settings → User Optionsand click theCreate API Tokenlink.
See the official guide:Create API Token using the FogBugz UI
Send the following request (replace placeholders with your values):
https://[your-fogbugz-server]/api.asp?cmd=logon&email=[your-email]&password=[your-password]
The response will contain your API token.
See the official guide:Get an API Token using FogBugz API commands
MCP is an open standard — this server works with any MCP-compatible AI client. Configuration varies by client.
One-click install:Download the latest.mcpbpackage from theReleasespage and open it — Claude Desktop will install and configure the server automatically, prompting you for your FogBugz URL and API token.
Manual configuration:Add to~/Library/Application Support/Claude/claude_desktop_config.json(macOS) or%APPDATA%\Claude\claude_desktop_config.json(Windows):
{ "mcpServers": { "fogbugz": { "command": "npx", "args": ["-y", "@todevs/fogbugz-mcp"], "env": { "FOGBUGZ_URL": "https://your-fogbugz-server.com", "FOGBUGZ_API_KEY": "your-api-token" } } } }
{ "mcpServers": { "fogbugz": { "command": "npx", "args": ["-y", "@todevs/fogbugz-mcp"], "env": { "FOGBUGZ_URL": "https://your-fogbugz-server.com", "FOGBUGZ_API_KEY": "your-api-token" } } } }
Any client that supports MCP stdio servers should work. Consult your client's documentation for how to register a stdio MCP server with environment variables. The server entry point isnpx @todevs/fogbugz-mcp(ornode /path/to/dist/index.jsfor a local build).
Example 1: Finding open bugs in a project
You:"Show me all open bugs in the Website project assigned to nobody."
Claude calls:search_caseswith queryproject:Website status:Active assignedTo:nobody category:Bug.
Result:A list of unassigned bugs with their IDs, titles, and creation dates — ready to triage or assign.
Example 2: Creating a case from a bug report
You:"Create a bug in the Mobile project titled 'Login button unresponsive on iOS 17', assign it to alice, and set priority to 2."
Claude calls:create_casewith project, title, assignee, and priority set in a single call, thenget_case_linkto return a direct URL.
Result:New case created. Claude confirms the case number and provides a link.
Example 3: Resolving a case with a closing comment
You:"Resolve case 1042 and add a comment saying the fix was deployed in v3.5.1."
Claude calls:resolve_casewith the case ID and a comment describing the fix.
Result:Case resolved. Claude confirms the status change and the comment was saved.
Example 4: Reviewing your team's workload
You:"What open cases does bob have right now?"
Claude calls:list_peopleto find Bob's user ID, thenlist_my_casesfiltered to that user.
Result:A summary of Bob's active cases grouped by project, with priorities and due dates.
Example 5: Updating a case after a code review
You:"Move case 987 to the Backend project, change the milestone to v4.0, and leave a comment saying it was re-scoped after the architecture review."
Claude calls:update_casewith the new project, milestone, and comment all set in one call.
Result:Case updated. Claude confirms each field change.
At startup the server automatically selects the right API client for your FogBugz instance:
- Probes/api.xmlto read the FogBugz version number.
- If version ≥ 9, attempts to reach the JSON API (/f/api/0/jsonapi) — usesFogBugzJsonClienton success.
- Falls back toFogBugzXmlClient(XML API via/api.asp) for version < 9 or if the JSON endpoint is unreachable.
Note on text formatting:Plain text only is supported in descriptions and comments when connected to FogBugz 8.x via the XML API. HTML and Markdown are stored and displayed literally.
# Latest stable release npx @todevs/fogbugz-mcp # Latest dev build (pre-release) npx @todevs/fogbugz-mcp@dev
git clone https://github.com/todevelopers/fogbugz-mcp.git cd fogbugz-mcp npm install npm run build node dist/index.js https://your-fogbugz-server.com your-api-token
npm run dev # run via ts-node (no build needed) npm run build # compile TypeScript to dist/ npm test # run all Jest tests
- FogBugz on-premise and on-demand (tested with FogBugz 8.8.53 via XML API)
- Node.js 20+
This server does not collect, store, or transmit any data to ToDevelopers or any third party. All communication is directly between your AI client and your own FogBugz instance using the URL and credentials you provide. No usage data, case content, or credentials are sent anywhere other than your configured FogBugz server.
For complete privacy information, see theFogBugz Privacy Policy.
This project is based on the original work bySarasvati Akari Lara-Almeida— thank you for the foundation.
MIT© Tomáš Gažovič, ToDevelopers s.r.o.
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Official MCP server for Buildable AI-powered development platform. Enables AI assistants to manage tasks, track progress, get project context, and collaborate with humans on software projects.
Objective-native planning board for agent-led development
A planning and orchestration system for AI-driven software development.
Interact with the CODING DevOps platform for managing projects and work items.
A development management tool for project planning, task management, and development workflows.
Access DevRev's APIs to manage work items, parts, search, and user information.
MCP server for Huly project management system
Integrates MantisBT bug tracker into Claude and other MCP clients via the REST API. Read and manage issues, notes, file attachments, tags, relationships, and monitors — with optional offline semantic search across all issues.
A server for managing sequential development tasks with configurable rules using external .mdc files.
Project management inside every AI coding tool — plans what's next, tracks every decision, stops drift.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





