P 69 Branch Monkey MCP

🚀 Branch Monkey MCP Server

The MCP (Model Context Protocol) server for Branch Monkey, connecting Claude Code to your task management and team collaboration platform.

🚀 Quick Start

Add the following to your project's .mcp.json:

{
  "mcpServers": {
    "branch-monkey-cloud": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/gneyal/p_69_branch_monkey_mcp.git", "branch-monkey-mcp"],
      "env": {
        "BRANCH_MONKEY_API_URL": "https://p-63-branch-monkey.pages.dev"
      }
    }
  }
}

Restart Claude Code. When using it for the first time, a browser will open for you to log in and approve the device.

✨ Features

• No API key needed - Authenticates via browser approval.
• Automatic token storage - Saved in ~/.branch-monkey/token.json.
• Task management - Create, update, and track tasks.
• Team collaboration - Share tasks with your team.
• Prompt tracking - Associate prompts with tasks.

💻 Usage Examples

Available Tools

Status & Auth

• monkey_status - Get connection status.
• monkey_login - Force re-authentication (use if having auth issues).
• monkey_logout - Clear auth token.

Projects & Organizations

• monkey_project_list - List all projects in your organization.
• monkey_project_focus - Set focus to a specific project.
• monkey_project_clear - Clear project focus.
• monkey_org_list - List organizations you have access to.

Tasks

• monkey_task_list - List all tasks.
• monkey_task_create - Create a new task.
• monkey_task_update - Update a task.
• monkey_task_delete - Delete a task.
• monkey_task_work - Start working on a task.
• monkey_task_log - Log progress on a task.
• monkey_task_complete - Mark task as complete.
• monkey_task_search - Search tasks.
• monkey_get_recent_tasks - Get recently worked tasks.
• monkey_auto_resume - Auto-detect related tasks.

Versions

• monkey_version_list - List versions.
• monkey_version_create - Create a version.

Team

• monkey_team_list - List team members.
• monkey_team_add - Add team member.

Machines

• monkey_machine_list - List machines.
• monkey_machine_create - Create a machine.

📚 Documentation

Troubleshooting

Authentication Issues

If you're having trouble connecting:

1. Use monkey_login - Forces re-authentication via browser.
2. Check the token file - Stored at ~/.branch-monkey/token.json.
3. Clear and retry - Use monkey_logout, then restart Claude Code.
4. Check network - Ensure you can access https://p-63-branch-monkey.pages.dev.

First-Time Setup

On first use:

1. A browser window opens automatically.
2. Log in to Branch Monkey (or create an account).
3. Select the organization you want to connect to.
4. Approve the device when prompted.
5. Return to Claude Code - you're connected!

After connecting, use monkey_project_list to see available projects and monkey_project_focus <id> to select one.

Requirements

• Python 3.10+
• uv package manager

📄 License

MIT