MCP server for Bugzilla — search, discuss, and manage Firefox/Mozilla bugs via the Bugzilla REST API.

Website · Documentation

Features

• Bug lookup — fetch any bug by ID or alias, including its full field-change history.
• Powerful search — filter by product, component, status, severity, assignee, keywords, or free-text quicksearch.
• Comment threads — read all comments on a bug, post new ones, and tag comments (e.g. spam, needinfo).
• Attachment management — list, upload, and update patches and files; set review flags inline.
• Write support — create and update bugs, change status, add CC members, and mark duplicates — all gated behind an API key so read-only use needs no credentials.
• Product and user discovery — enumerate products, components, versions, flag types, field definitions, and look up users by email.

Install

Register the server with your MCP client. For Claude Desktop, add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-bugzilla": {
      "command": "npx",
      "args": ["-y", "@kud/mcp-bugzilla"],
      "env": {
        "MCP_BUGZILLA_API_KEY": "your-api-key-here"
      }
    }
  }
}

MCP_BUGZILLA_API_KEY is optional — omit it for read-only access. To obtain a key, visit your Bugzilla API Keys preferences page.

The MCP_BUGZILLA_BASE_URL environment variable overrides the default endpoint (https://bugzilla.mozilla.org/rest) for self-hosted instances.

Usage

The server exposes 17 tools across six areas. Tools marked with 🔑 require MCP_BUGZILLA_API_KEY.

Tool	Area	Auth	Description
get_bug	Bugs	—	Fetch a single bug by ID or alias
search_bugs	Bugs	—	Search with filters or full-text quicksearch
create_bug	Bugs	🔑	File a new bug
update_bug	Bugs	🔑	Update fields, status, keywords, CC, or close as duplicate
get_bug_history	Bugs	—	Get the field-change history for a bug
get_comments	Comments	—	Get all comments, optionally filtered by date
create_comment	Comments	🔑	Post a comment, optionally with work-time logging
search_comment_tags	Comments	—	Search available comment tag names
update_comment_tags	Comments	🔑	Add or remove tags on a comment
get_attachments	Attachments	—	List attachments for a bug
create_attachment	Attachments	🔑	Upload a patch or file (base64-encoded)
update_attachment	Attachments	🔑	Rename, mark obsolete, or change flags on an attachment
get_products	Products	—	List accessible products
get_product	Products	—	Get product details including components and versions
get_user	Users	—	Look up a user by email or login name
get_bug_fields	Fields	—	List bug fields and their legal values
get_flag_types	Flags	—	List flag types for a product/component

Development

git clone https://github.com/kud/mcp-bugzilla.git
cd mcp-bugzilla
npm install
npm run dev

Script	Description
npm run build	Compile TypeScript to dist/
npm run dev	Run source directly via tsx
npm test	Run the Vitest test suite
npm run typecheck	Type-check without emitting
npm run inspect:dev	Open MCP Inspector against source

📚 Full documentation → mcp-bugzilla/docs