claude-code-teams-mcp

Name: claude-code-teams-mcp
Author: cs50victor

Verified

use claude code's agent teams orchestraction with any harness

275stars

40forks

Python

Installation

# Add to your Claude Code skills
git clone https://github.com/cs50victor/claude-code-teams-mcp

Getting Started

Guides for using ai agents skills like claude-code-teams-mcp.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 5/30/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-05-30T15:14:29.609Z",
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is claude-code-teams-mcp?

claude-code-teams-mcp is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by cs50victor. use claude code's agent teams orchestraction with any harness. It has 275 GitHub stars.

Is claude-code-teams-mcp safe to use?

Yes. claude-code-teams-mcp passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install claude-code-teams-mcp?

Clone the repository with "git clone https://github.com/cs50victor/claude-code-teams-mcp" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is claude-code-teams-mcp written in?

claude-code-teams-mcp is primarily written in Python. It is open-source under cs50victor on GitHub, so you can review or fork the full source.

Are there alternatives to claude-code-teams-mcp?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh claude-code-teams-mcp against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

termly-cli revenue-centric-design

claude-teams

MCP server that implements Claude Code's agent teams protocol for any MCP client.

https://github.com/user-attachments/assets/531ada0a-6c36-45cd-8144-a092bb9f9a19

Claude Code has a built-in agent teams feature (shared task lists, inter-agent messaging, tmux-based spawning), but the protocol is internal and tightly coupled to its own tooling. This MCP server reimplements that protocol as a standalone MCP server, making it available to any MCP client: Claude Code, OpenCode, or anything else that speaks MCP. Based on a deep dive into Claude Code's internals. PRs welcome.

Install

Pin to a release tag (e.g. @v0.1.1), not main. There are breaking changes between releases.

Claude Code (.mcp.json):

{
  "mcpServers": {
    "claude-teams": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/cs50victor/claude-code-teams-mcp@v0.1.1", "claude-teams"]
    }
  }
}

OpenCode (~/.config/opencode/opencode.json):

{
  "mcp": {
    "claude-teams": {
      "type": "local",
      "command": ["uvx", "--from", "git+https://github.com/cs50victor/claude-code-teams-mcp@v0.1.1", "claude-teams"],
      "enabled": true
    }
  }
}

Requirements

Python 3.12+
tmux
At least one coding agent on PATH: Claude Code (claude) or OpenCode (opencode)
OpenCode teammates require OPENCODE_SERVER_URL and the claude-teams MCP connected in that instance

Configuration

Variable	Description	Default
`CLAUDE_TEAMS_BACKENDS`	Comma-separated enabled backends (`claude`, `opencode`)	Auto-detect from connecting client
`OPENCODE_SERVER_URL`	OpenCode HTTP API URL (required for opencode teammates)	(unset)
`USE_TMUX_WINDOWS`	Spawn teammates in tmux windows instead of panes	(unset)

Without CLAUDE_TEAMS_BACKENDS, the server auto-detects the connecting client and enables only its backend. Set it explicitly to enable multiple backends:

{
  "mcpServers": {
    "claude-teams": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/cs50victor/claude-code-teams-mcp@v0.1.1", "claude-teams"],
      "env": {
        "CLAUDE_TEAMS_BACKENDS": "claude,opencode",
        "OPENCODE_SERVER_URL": "http://localhost:4096"
      }
    }
  }
}

Tools

Tool	Description
`team_create`	Create a new agent team (one per session)
`team_delete`	Delete team and all data (fails if teammates active)
`spawn_teammate`	Spawn a teammate in tmux
`send_message`	Send DMs, broadcasts (lead only), shutdown/plan responses
`read_inbox`	Read messages from an agent's inbox
`read_config`	Read team config and member list
`task_create`	Create a task (auto-incrementing ID)
`task_update`	Update task status, owner, dependencies, or metadata
`task_list`	List all tasks
`task_get`	Get full task details
`force_kill_teammate`	Kill a teammate's tmux pane/window and clean up
`process_shutdown_approved`	Remove teammate after graceful shutdown

Architecture

Spawning: Teammates launch in tmux panes (default) or windows (USE_TMUX_WINDOWS). Each gets a unique agent ID and color.
Messaging: JSON inboxes at ~/.claude/teams/<team>/inboxes/. Lead messages anyone; teammates message only lead.
Tasks: JSON files at ~/.claude/tasks/<team>/. Status tracking, ownership, and dependency management.
Concurrency: Atomic writes via tempfile + os.replace. Cross-platform file locks via filelock.

~/.claude/
├── teams/<team>/
│   ├── config.json
│   └── inboxes/
│       ├── team-lead.json
│       ├── worker-1.json
│       └── .lock
└── tasks/<team>/
    ├── 1.json
    ├── 2.json
    └── .lock

License

MIT