git-bug-mcp

An MCP server that wraps the git-bug distributed bug tracker, enabling bug management directly from Claude and other MCP-compatible AI assistants.

Prerequisites

• Python >= 3.10
• git-bug binary in your PATH
• A git repository with git bug initialized

Installation

Claude Code

Important: This MCP server should be installed per-project, not globally. git-bug tracks bugs inside each git repository, so a global MCP server can lead to bugs being filed in the wrong repo.

Install into a specific project with --scope project:

cd /path/to/your-project
claude mcp add git-bug --scope project -- \
  uv run --directory /path/to/git-bug-mcp git-bug-mcp

This writes the config to your project's .claude/settings.json so the git-bug tools are only available when Claude Code is launched from that directory.

Environment Variables

Variable	Description
GIT_BUG_REPO	Path to the git repository. Can also be overridden per-tool call via the repo_dir parameter. Defaults to the current working directory.

Tools

Querying

Tool	Description
list_bugs	List and filter bugs by status, author, label, title, sort field, and direction
show_bug	Get full details of a bug including comments, labels, and history
list_comments	List all comments on a specific bug
list_labels	List all labels in use across bugs
list_users	List all known identities in the repository
list_bridges	List configured bridges to external trackers

Mutations

Tool	Description
create_bug	Create a new bug with title and optional description
add_comment	Add a comment to a bug
edit_comment	Edit an existing comment
set_status	Open or close a bug
edit_title	Change a bug's title
add_labels	Add labels to a bug
remove_labels	Remove labels from a bug
remove_bug	Permanently remove a bug

User Management

Tool	Description
create_user	Create a new identity with name and optional email
adopt_user	Adopt an existing identity as your own

Synchronization

Tool	Description
push	Push bug data to a git remote
pull	Pull bug data from a git remote
bridge_pull	Import bugs from an external tracker (GitHub, GitLab, Jira)
bridge_push	Export bugs to an external tracker

Project Structure

src/git_bug_mcp/
├── server.py     # MCP server and tool definitions
└── git_bug.py    # Async wrapper around the git-bug CLI

License

MIT