pit

local issue tracker MCP server — one binary, one SQLite file.

---

pit is a lightweight issue tracker that runs as an MCP server. It stores everything in a single SQLite database, so there's nothing to configure and no external services to manage.

Built for use with Claude Code and other MCP-compatible clients.

Features

• Single binary, single file — no setup, no accounts, no network dependency
• Full-text search — powered by SQLite FTS5
• Labels — auto-created on first use
• Comments — threaded context on any issue
• Issue lifecycle — open → in-progress → closed

Install

curl -fsSL https://raw.githubusercontent.com/uname-n/pit/master/install.sh | sh

Setup

claude mcp add pit -- pit

Or add pit to your project's .mcp.json:

{
  "mcpServers": {
    "pit": {
      "command": "pit"
    }
  }
}

pit will create a .pit/db.sqlite file in your working directory. To use a custom path, set the PIT_DB environment variable.

Tools

Tool	Description
create_issue	Create a new issue with optional body, labels, and status
list_issues	List issues with filtering by status/labels, sorting, and pagination
get_issue	Get a single issue with all its comments
update_issue	Update title, body, status, labels, or close reason
add_comment	Add a comment to an issue
search_issues	Full-text search across titles, bodies, and comments
list_labels	List all labels with issue counts
delete_issue	Delete an issue and its comments