BMAD

The BMAD MCP Server provides a programmable foundation for managing intelligent multi-agent workflows, task tracking, time and cost accounting, and cross-IDE project management using the MCP protocol. It enables you to run and orchestrate specialized agents, automate complex project lifecycles, and integrate with tooling and databases to streamline product development.

How to use

You interact with the BMAD MCP Server through your MCP client. Start by configuring a local MCP client to connect to the server, then request agent guidance, create and track tasks, and monitor progress in real time. Use the included tools to activate the appropriate agent, manage tasks, and run BMAD-METHOD workflows. You can also enable time and cost tracking to generate billing-ready reports and simulate workday scenarios to test workflows.

How to install

# Prerequisites
- Python 3.8+
- Git
- Access to an internet connection

# 1. Clone the repository
git clone https://github.com/yourusername/bmad-mcp-server.git
cd bmad-mcp-server

# 2. Install dependencies
pip install -r requirements.txt

# 3. Set up environment variables
cp .env.example .env
# Edit .env with your API keys

Configuration and usage notes

Configure your MCP client to connect to the BMAD MCP Server using a local (stdio) runtime. You run the server locally with Python and point the client to the server entry points exposed below.

Two example client configurations are provided for different IDEs. Ensure you configure the same runtime command and working directory in your IDEs.

Security and environment

Environment variables are used to securely provide API keys and tokens. Do not commit secrets to source control. Use separate credentials for development and production where possible.

Troubleshooting tips

If your client cannot reach the server, verify the working directory and the Python command in your IDE configuration. Check that required environment variables are set and that the server process has the proper permissions to run.

Examples and workflows

You can follow practical patterns to activate an agent, create tasks, and track time. Use the tools to observe live progress, schedule work, and generate billing-ready reports.

Available tools

bmad_list_agents

List all available agents that you can activate to perform specialized tasks

bmad_activate_agent

Switch to a specific agent to handle a task set

bmad_get_agent_help

Retrieve agent-specific guidance to tailor workflows

bmad_get_task_summary

Get a comprehensive overview of current tasks and statuses

bmad_create_task

Create a new task with auto-scheduling and agent assignment

bmad_update_task_progress

Update progress for a task with real-time sync

bmad_get_today_tasks

View today’s scheduled tasks for workload planning

bmad_get_agent_tasks

Obtain tasks assigned to a specific agent

bmad_start_timer

Begin time tracking for a task for cost and billing

bmad_stop_timer

Stop timer and calculate costs based on AI usage and tokens

bmad_get_project_billing

Generate billing reports in JSON, CSV, or invoice formats

bmad_workflow_start_project

Start BMAD-METHOD project workflow for end-to-end execution

bmad_workflow_advance

Advance the workflow to the next state ensuring proper transitions

bmad_workflow_run_qa

Execute quality gates through predefined @qa commands

bmad_coder_activate_project

Activate a project for semantic code analysis

bmad_create_project

Create a new project with a standardized BMAD structure

bmad_create_document

Generate documents from templates for reporting and planning

bmad_simulate_work_day

Simulate a realistic workday progression for testing

bmad_detect_project

Auto-discover BMAD configurations in a path

bmad_register_project

Register a project in the global registry for cross-IDE access

bmad_list_project_templates

Show all available BMAD templates for new projects

bmad_migrate_project_to_standard

Migrate existing projects to the BMAD v2.0 standard

bmad_get_project_status

Provide a comprehensive status across multiple projects

bmad_sync_notion_tasks

Bi-directional sync with Notion databases

bmad_workflow_generate_report

Create detailed workflow reports with analytics