mcp-bugzilla — Bugzilla MCP Server

Features

Everything you need for Bugzilla

Works read-only without credentials. Add an API key to unlock bug creation, comments, and status updates — all from your AI assistant.

🔑

Optional authentication

Read-only access requires no API key. Generate one from Bugzilla preferences to unlock create, update, and comment operations.

🔎

Powerful search

Filter by product, component, status, severity, assignee, or use Bugzilla's quicksearch syntax to find exactly the right bugs.

💬

Full discussion flow

Read comments, post replies, mark them private, or log work time — the complete comment lifecycle without leaving your editor.

📌

Attachment handling

List, create, and update attachments on any bug. Inspect patches and test files linked to open Firefox issues.

🦊

Mozilla-first defaults

Defaults to bugzilla.mozilla.org out of the box. Override MCP_BUGZILLA_BASE_URL for any self-hosted Bugzilla instance.

⚡

Zero-install via npx

Add one JSON block to your Claude Desktop config and restart. TypeScript, ESM, Node 20+ — no global installs needed.

Quick Start

Up and running in two minutes

Add the server block to your Claude Desktop config, optionally set your API key, and restart the app.

Open your Claude Desktop config

Edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or %APPDATA%\Claude\claude_desktop_config.json on Windows.

Add the server block

Paste this snippet into your mcpServers object. The env section is optional — omit it for read-only access.

claude_desktop_config.json

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

Or use Claude Code CLI

Terminal

claude mcp add mcp-bugzilla \
  -e MCP_BUGZILLA_API_KEY=your-key \
  -- npx -y @kud/mcp-bugzilla

Restart and start asking

Restart Claude Desktop (or reload your editor). The 17 Bugzilla tools are now available. Try: "Show me bug 1234567" or "Search for open P1 Firefox crashes".

MCP Tools Reference

17 tools, full API coverage

Read operations work without an API key. Tools marked write require MCP_BUGZILLA_API_KEY.

Tool	Description
Bugs
get_bug	Fetch a single bug by ID or alias, including all metadata fields.
search_bugs	Search bugs by product, component, status, assignee, severity, or quicksearch syntax.
create_bug write	File a new bug with product, component, summary, description, and optional fields.
update_bug write	Update status, resolution, assignee, keywords, CC list, and other fields on an existing bug.
get_bug_history	View the full field-change audit trail for a bug, with timestamps and authors.
Comments
get_comments	Retrieve all comments on a bug, with an optional `new_since` date filter.
create_comment write	Post a comment, optionally marking it private or logging work time against the bug.
search_comment_tags	Search for comment tags across bugs matching a query string.
update_comment_tags write	Add or remove tags on a specific comment.
Attachments
get_attachments	List all attachments (patches, screenshots, logs) for a bug.
create_attachment write	Upload a new attachment to a bug with MIME type, file name, and content.
update_attachment write	Update attachment metadata — description, MIME type, or patch/obsolete flags.
Products
get_products	List accessible, selectable, or enterable products on the Bugzilla instance.
get_product	Get full product details including all components, versions, and milestones.
Users & Fields
get_user	Look up a Bugzilla user by email address or login name.
get_bug_fields	List all available bug fields and their legal values (e.g. valid severities).
get_flag_types	Retrieve flag types available for a given product and component.

Configuration

Two environment variables

Both are optional. The server works read-only with no configuration at all — just add your API key when you need to create or update bugs.

MCP_BUGZILLA_API_KEY

Your Bugzilla API key. Required for write operations (create bug, post comment, upload attachment, update status). Generate one at Preferences → API Keys.

Optional

MCP_BUGZILLA_BASE_URL

Base URL of the Bugzilla REST API. Defaults to https://bugzilla.mozilla.org/rest. Override this to point at any self-hosted Bugzilla instance.