Branch Monkey MCP Server

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

Quick Start

Add this 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. On first use, 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, track tasks
• Team collaboration - Share tasks with your team
• Prompt tracking - Associate prompts with tasks

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

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