Claude MPM - Multi-Agent Project Manager

A comprehensive workflow and agent management framework for Claude Code that transforms your AI coding assistant into a full-featured development platform with multi-agent orchestration, skills system, MCP integration, session management, and semantic code search.

⚠️ Important: Claude MPM requires Claude Code CLI (v1.0.92+; v2.1.3+ to use Skills features), not Claude Desktop (app). All MCP integrations work with Claude Code's CLI interface only.

Don't have Claude Code? Install from: https://docs.anthropic.com/en/docs/claude-code

Quick Start: See Getting Started Guide to get running in 5 minutes!

Current stable version: v6.5.43 — plugin install path, binary consolidation, and auto-migration. See Beta Guide for the v6.0 release notes and CHANGELOG for the full history.

---

Quick Start

Plugin Install (recommended for most users)

The fastest way to get started. No pip install required — provides hooks, 56 skills, slash commands, and MCP server config directly inside Claude Code.

# Add the MPM marketplace
claude plugin marketplace add bobmatnyc/claude-mpm-marketplace

# Install the plugin
claude plugin install claude-mpm@claude-mpm-marketplace

This gives you: 6 hook events, 56 skills, 2 slash commands (/mpm-status, /mpm-help), and MCP server configuration — all without pip install.

Full Install (for power users)

For CLI commands, multi-agent orchestration, monitoring dashboard, and all integrations:

# Install the full package (from home directory)
cd ~
uv tool install "claude-mpm[monitor,data-processing]" --python 3.13

# Then also install the plugin for Claude Code integration
claude plugin marketplace add bobmatnyc/claude-mpm-marketplace
claude plugin install claude-mpm@claude-mpm-marketplace

See Installation below for all installation methods.

---

Who Should Use Claude MPM?

• 👥 Non-Technical Users (Founders/PMs) - Research and understand codebases using Research Mode - no coding experience required
• 💻 Developers - Multi-agent development workflows with semantic code search and advanced features
• 🏢 Teams - Collaboration patterns, session management, and coordinated workflows

---

What is Claude MPM?

Claude MPM transforms Claude Code into a comprehensive AI development platform with:

🤖 Multi-Agent System

• 47+ Specialized Agents - Python, TypeScript, Rust, Go, Java, Ruby, PHP, QA, Security, DevOps, and more
• Intelligent PM Orchestration - Automatic task routing to specialist agents
• Agent Sources - Deploy agents from Git repositories with ETag-based caching

🎯 Skills Framework

• 56+ Bundled Skills - TDD, debugging, Docker, API design, security scanning, Git workflows
• Progressive Disclosure - Skills load on-demand to optimize context usage
• Three-Tier Organization - Bundled → User → Project priority resolution
• Domain Authority System - Auto-generated agent/tool discovery skills for intelligent PM delegation
• Skills Optimization - Intelligent project analysis with automated skill recommendations

🔌 MCP Integration (Model Context Protocol)

• Google Workspace MCP - 67 tools for Gmail, Calendar, Drive, Docs, Sheets, Slides, Tasks
• Notion - pages and databases via the official Notion MCP server
• Confluence - pages, spaces, CQL search + bulk operations
• Slack - User proxy for channels, messages, DMs, search
• Semantic Code Search - AI-powered code discovery via trusty-search
• Ticket Management - GitHub, Linear, Jira integration via mcp-ticketer
• Persistent Memory - Project knowledge palace via trusty-memory

📊 Session & Workflow Management

• Session Resume - Continue work with full context preservation
• Auto-Pause - Automatic context summaries at 70%/85%/95% thresholds
• Real-Time Dashboard - Live monitoring of agent activity
• Hooks System - 15+ event hooks for custom workflows

🔐 Enterprise Features

• OAuth 2.0 Integration - Secure Google Workspace authentication
• Encrypted Token Storage - Fernet encryption with system keychain
• 100+ CLI Commands - Comprehensive management interface
• 60+ Services - Service-oriented architecture with event bus

---

Quick Installation

Prerequisites

1. Python 3.11-3.13 (Python 3.13 recommended; 3.14 NOT yet supported)
2. Claude Code CLI v1.0.92+ (required!; v2.1.3+ to use Skills features)
3. GitHub Token (recommended for skill sources)

Python Version Warning:

• macOS default Python 3.9 is too old - use --python 3.13 flag
• Python 3.13 is recommended and fully tested
• Python 3.14 is NOT yet supported - installation will fail

# Verify Claude Code is installed
claude --version

# If not installed, get it from:
# https://docs.anthropic.com/en/docs/claude-code

# Set GitHub token (recommended - avoids rate limits)
export GITHUB_TOKEN=your_github_token

Install Claude MPM

Option A: Plugin Only (no pip required)

# Add the MPM marketplace and install the plugin
claude plugin marketplace add bobmatnyc/claude-mpm-marketplace
claude plugin install claude-mpm@claude-mpm-marketplace

This provides hooks, 56 skills, slash commands, and MCP config. For the full CLI, agents, monitor, and dashboard, continue with Option B.

Option B: Full Install (pip + plugin)

IMPORTANT: Install from your home directory, NOT from within a cloned git repository.

uv (recommended):

# From home directory (IMPORTANT!)
cd ~

# Install with Python 3.13 (not 3.9 or 3.14)
uv tool install "claude-mpm[monitor,data-processing]" --python 3.13

Homebrew (macOS):

brew tap bobmatnyc/tools
brew install claude-mpm

pipx:

cd ~
pipx install "claude-mpm[monitor]"

Post-Installation Setup (Required)

These steps must be completed before running claude-mpm doctor:

# Create required directories
mkdir -p ~/.claude/{responses,memory,logs}

# Deploy agents
claude-mpm agents deploy

# Add skill source (recommended)
claude-mpm skill-source add https://github.com/bobmatnyc/claude-mpm-skills

Verify Installation

# Run diagnostics (after completing setup above)
claude-mpm doctor --verbose

# Check versions
claude-mpm --version
claude --version

# Auto-configure your project
cd ~/your-project
claude-mpm auto-configure

What You Should See:

• 47+ agents deployed to ~/.claude/agents/
• 56+ bundled skills (in Python package)
• Agent sources configured
• All doctor checks passing

Recommended Partners: Install these companion tools for enhanced capabilities:

uv tool install trusty-memory --python 3.13
uv tool install trusty-search --python 3.13
uv tool install mcp-ticketer --python 3.13
uv tool install mcp-browser --python 3.13

Tool Version Management: Use ASDF version manager to avoid Python/uv version conflicts across projects.

---

Key Features

🎯 Multi-Agent Orchestration

• 47+ Specialized Agents from Git repositories covering all development needs
• Smart Task Routing via PM agent intelligently delegating to specialists
• Session Management with --resume flag for seamless continuity
• Resume Log System with automatic 10k-token summaries at 70%/85%/95% thresholds

→ Learn more: Multi-Agent Development

📦 Git Repository Integration

• Curated Content with 47+ agents automatically deployed from repositories
• Always Up-to-Date with ETag-based caching (95%+ bandwidth reduction)
• Hierarchical BASE-AGENT.md for template inheritance and DRY principles
• Custom Repositories via claude-mpm agent-source add

→ Learn more: Agent Sources

🎯 Skills System

• 56+ Bundled Skills covering Git, TDD, Docker, API design, security, debugging, and more
• Three-Tier Organization: Bundled/user/project with priority resolution
• Auto-Linking to relevant agents based on roles
• Progressive Disclosure - Skills load on-demand to optimize context
• Custom Skills via .claude/skills/ or skill repositories

→ Learn more: Skills Guide

🔍 Semantic Code Search

• AI-Powered Discovery with trusty-search integration
• Find by Intent not just keywords ("authentication logic" finds relevant code)
• Pattern Recognition for discovering similar implementations
• Live Updates tracking code changes automatically

→ Learn more: Developer Use Cases

🔌 Advanced Integration

• MCP Integration with full Model Context Protocol support
• MCP Session Server (claude-mpm mcp serve session) for programmatic session management
• Real-Time Monitoring via --monitor flag and web dashboard
• Multi-Project Support with per-session working directories
• Git Integration with diff viewing and change tracking

→ Learn more: MCP Gateway | → MCP Session Server

🔐 External Integrations

• Browser-Based OAuth for secure authentication with MCP services
• Google Workspace MCP (`gworkspace-mcp