Claude Code workflow and agent management framework - Multi-agent orchestration, skills system, MCP integration, session management, and semantic code search for AI-powered development
Project description
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 (v2.1.3+), 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!
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
- 44+ 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
๐ MCP Integration (Model Context Protocol)
- Google Workspace MCP - 34 tools for Gmail, Calendar, Drive, Docs, Tasks
- Notion - 7 tools + bulk operations for databases, pages, markdown import
- Confluence - 7 tools + bulk operations for pages, spaces, CQL search
- Slack - User proxy for channels, messages, DMs, search
- Semantic Code Search - AI-powered code discovery via mcp-vector-search
- Ticket Management - GitHub, Linear, Jira integration via mcp-ticketer
- Graph Memory - Persistent project knowledge via kuzu-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
- Python 3.11-3.13 (Python 3.13 recommended; 3.14 NOT yet supported)
- Claude Code CLI v2.1.3+ (required!)
- GitHub Token (recommended for skill sources)
Python Version Warning:
- macOS default Python 3.9 is too old - use
--python 3.13flag- 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
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/ - 44+ bundled skills (in Python package)
- Agent sources configured
- All doctor checks passing
Recommended Partners: Install these companion tools for enhanced capabilities:
uv tool install kuzu-memory --python 3.13
uv tool install mcp-vector-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
--resumeflag 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
๐ฏ Skills System
- 44+ 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
๐ Semantic Code Search
- AI-Powered Discovery with mcp-vector-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
๐งช MPM Commander (ALPHA)
- Multi-Project Orchestration with autonomous AI coordination across codebases
- Tmux Integration for isolated project environments and session management
- Event-Driven Architecture with inbox system for cross-project communication
- LLM-Powered Decisions via OpenRouter for autonomous work queue processing
- Real-Time Monitoring with state tracking (IDLE, WORKING, BLOCKED, PAUSED, ERROR)
- โ ๏ธ Experimental - API and CLI interface subject to change
๐ Advanced Integration
- MCP Integration with full Model Context Protocol support
- MCP Session Server (
mpm-session-server) for programmatic session management - Real-Time Monitoring via
--monitorflag 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 built-in server with 34 tools for:
- Gmail (5 tools): Search, read, send, draft, reply
- Calendar (6 tools): List, get, create, update, delete events
- Drive (7 tools): Search, read, create folders, upload, delete, move files
- Docs (4 tools): Create, read, append, markdown-to-doc conversion
- Tasks (12 tools): Full task and task list management
- Notion MCP built-in server with 7 tools + bulk operations:
- Query databases, get/create/update pages, search, markdown import
- Setup:
claude-mpm setup notion
- Confluence MCP built-in server with 7 tools + bulk operations:
- Get/create/update pages, search with CQL, list spaces, markdown import
- Setup:
claude-mpm setup confluence
- Slack MCP user proxy with 12 tools:
- Channels, messages, DMs, search - acts as authenticated user
- Setup:
claude-mpm setup slack
- Encrypted Token Storage using Fernet encryption with system keychain
- Automatic Token Refresh handles expiration seamlessly
# Set up Google Workspace OAuth
claude-mpm oauth setup workspace-mcp
# Set up Notion (API token)
claude-mpm setup notion
# Set up Confluence (URL + API token)
claude-mpm setup confluence
# Set up Slack (OAuth user token)
claude-mpm setup slack
# Check token status
claude-mpm oauth status workspace-mcp
# List OAuth-capable services
claude-mpm oauth list
โ Google Workspace Setup | โ Notion Setup | โ Confluence Setup | โ Slack Setup
โก Performance & Security
- Simplified Architecture with ~3,700 lines removed for better performance
- Enhanced Security with comprehensive input validation
- Intelligent Caching with ~200ms faster startup via hash-based invalidation
- Memory Management with cleanup commands for large conversation histories
โ๏ธ Automatic Migrations
- Seamless Updates with automatic configuration migration on first startup after update
- One-Time Fixes for cache restructuring and configuration changes
- Non-Blocking failures log warnings but do not stop startup
- Tracked in
~/.claude-mpm/migrations.yaml
โ Learn more: Startup Migrations
Quick Usage
# Start interactive mode
claude-mpm
# Start with monitoring dashboard
claude-mpm run --monitor
# Resume previous session
claude-mpm run --resume
# Semantic code search
claude-mpm search "authentication logic"
# or inside Claude Code:
/mpm-search "authentication logic"
# Health diagnostics
claude-mpm doctor
# Verify MCP services
claude-mpm verify
# Manage memory
claude-mpm cleanup-memory
๐ก Update Checking: Claude MPM automatically checks for updates and verifies Claude Code compatibility on startup. Configure in ~/.claude-mpm/configuration.yaml or see docs/update-checking.md.
โ Complete usage examples: User Guide
What's New in v5.0
Git Repository Integration for Agents & Skills
- ๐ฆ Massive Library: 47+ agents and hundreds of skills deployed automatically
- ๐ข Official Content: Anthropic's official skills repository included by default
- ๐ง Fully Extensible: Add your own repositories with immediate testing
- ๐ณ Smart Organization: Hierarchical BASE-AGENT.md inheritance
- ๐ Clear Visibility: Two-phase progress bars (sync + deployment)
- โ Fail-Fast Testing: Test repositories before they cause startup issues
Quick Start with Custom Repositories:
# Add custom agent repository
claude-mpm agent-source add https://github.com/yourorg/your-agents
# Add custom skill repository
claude-mpm skill-source add https://github.com/yourorg/your-skills
# Test repository without saving
claude-mpm agent-source add https://github.com/yourorg/your-agents --test
Documentation
๐ Complete Documentation Hub - Start here for all documentation!
Quick Links by User Type
๐ฅ For Users
- ๐ 5-Minute Quick Start - Get running immediately
- ๐ฆ Installation Guide - All installation methods
- ๐ User Guide - Complete user documentation
- โ FAQ - Common questions answered
๐ป For Developers
- ๐๏ธ Architecture Overview - Service-oriented system design
- ๐ป Developer Guide - Complete development documentation
- ๐งช Contributing - How to contribute
- ๐ API Reference - Complete API documentation
๐ค For Agent Creators
- ๐ค Agent System - Complete agent development guide
- ๐ Creation Guide - Step-by-step tutorials
- ๐ Schema Reference - Agent format specifications
๐ For Operations
- ๐ Deployment - Release management & versioning
- ๐ Monitoring - Real-time dashboard & metrics
- ๐ Troubleshooting - Enhanced
doctorcommand with auto-fix
Integrations
Claude MPM supports multiple integrations for enhanced functionality. See Complete Integration Documentation for detailed setup guides.
Core Integrations
- kuzu-memory - Graph-based semantic memory for project context
- mcp-vector-search - AI-powered semantic code search and discovery
External Services
- Google Workspace MCP - Gmail, Calendar, Drive, Docs, Tasks (67 tools)
- Slack - Slack workspace integration via user proxy
- Notion - Notion databases and pages (7 MCP tools + bulk CLI)
- Confluence - Confluence pages and spaces (7 MCP tools + bulk CLI)
Quick Setup
# Setup any integration with one command
claude-mpm setup <integration>
# Examples:
claude-mpm setup kuzu-memory
claude-mpm setup mcp-vector-search
claude-mpm setup google-workspace-mcp
claude-mpm setup slack
claude-mpm setup notion
claude-mpm setup confluence
# Setup multiple at once
claude-mpm setup kuzu-memory mcp-vector-search google-workspace-mcp
Integration Features:
- One-command setup for all services
- Secure OAuth 2.0 authentication (Google Workspace, Slack)
- Encrypted token storage in system keychain
- Automatic token refresh
- MCP protocol for standardized tool interfaces
- Bulk CLI operations for high-performance batch processing
Contributing
Contributions are welcome! Please see:
- Contributing Guide - How to contribute
- Code Formatting - Code quality standards
- Project Structure - Codebase organization
Development Workflow:
# Complete development setup
make dev-complete
# Or step by step:
make setup-dev # Install in development mode
make setup-pre-commit # Set up automated code formatting
๐ License
Licensed under the Elastic License 2.0 - free for internal use and commercial products.
Main restriction: Cannot offer as a hosted SaaS service without a commercial license.
๐ Licensing FAQ | ๐ผ Commercial licensing: bob@matsuoka.com
Credits
- Based on claude-multiagent-pm
- Enhanced for Claude Code (CLI) integration
- Built with โค๏ธ by the Claude MPM community
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
claude_mpm-5.7.27.tar.gz
(4.4 MB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file claude_mpm-5.7.27.tar.gz.
File metadata
- Download URL: claude_mpm-5.7.27.tar.gz
- Upload date:
- Size: 4.4 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e3470c81269b12c6744097e7dc4e9af6039244cd72689c18b4b45eacf4909f85
|
|
| MD5 |
8cb7d4285284480ce60d1cfa6e381c9e
|
|
| BLAKE2b-256 |
cf91e6e56082697015bcb5f4065127dc8819b7725f6d4fee87fc84c67cf49bb3
|
File details
Details for the file claude_mpm-5.7.27-py3-none-any.whl.
File metadata
- Download URL: claude_mpm-5.7.27-py3-none-any.whl
- Upload date:
- Size: 4.3 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0cd7fef85198cf7d91b016d83c9ce5436598b6ad4d18911f45f223e31498dace
|
|
| MD5 |
e381cd527e16799ca97af97639adc911
|
|
| BLAKE2b-256 |
9798ca6cdda8efe8a6f1984370de84099be242dce3260782102fbbf7e6e86ef1
|
