TPM

tpm-mcp is a local MCP server that lets Claude act as your private AI-powered Technical Project Manager. It tracks your organizations, projects, features, and tasks, stores everything locally in SQLite, and keeps your data off the cloud so you can plan, break down work, and ship faster with complete privacy.

How to use

You use tpm-mcp with Claude by connecting the MCP server to Claude and then issuing natural-language prompts. You can ask for a full roadmap, create new tickets, break down features into tasks, update priorities, and check what’s blocking you. The data is organized hierarchically as organizations → projects → tickets → tasks, and Claude will reflect statuses, priorities, assignees, and notes in the roadmaps and task lists.

How to install

Prerequisites: you need a working environment with Python and the uv tool installed so you can run MCP servers locally.

git clone https://github.com/yourusername/tpm-mcp.git
cd tpm-mcp
uv venv && uv pip install -e .

Add the MCP server to Claude

Configure Claude to communicate with your local tpm-mcp server so you can issue commands directly from Claude’s interface.

claude mcp add tpm --scope user -- uv run --directory /path/to/tpm-mcp tpm-mcp

Manual settings for Claude to locate the server

If you prefer to edit settings directly, add the MCP server configuration to your Claude settings file.

{
  "mcpServers": {
    "tpm": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/tpm-mcp", "tpm-mcp"]
    }
  }
}

Optional: Enable TPM agent behavior

For a richer experience, you can enable a TPM agent workflow by linking a guide into your project’s Claude folder.

# Symlink to your project's .claude folder
mkdir -p .claude
ln -s /path/to/tpm-mcp/agents/tpm.md .claude/tpm.md

Optional: Add agent note to Claude project

In your CLAUDE.md, reference the TPM workflow to remind Claude users where to find the project tracking rules.

See .claude/tpm.md for project tracking workflow.

Available tools

roadmap_view

Shows the full roadmap with all orgs, projects, tickets, and tasks.

ticket_get

Displays detailed information for a single ticket and its tasks.

info

Provides server stats and database information.

ticket_create

Create a new ticket with title, description, priority, and tags.

ticket_update

Update status, priority, assignees, and other ticket fields.

ticket_list

List tickets with filters by project or status.

ticket_search

Full-text search on tickets with optional filters.

task_create

Create a task under a specific ticket.

task_update

Update task status, details, and complexity.

task_list

List tasks with filters by ticket or status.

org_create

Create a new organization.

org_list

List all organizations.

project_create

Create a new project within an organization.

project_list

List all projects.

note_add

Add notes to any entity.