Skip to content
Back to search

claude-code-teams-mcp

use claude code's agent teams orchestraction with any harness

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/cs50victor--claude-code-teams-mcp/badge.svg)](/listings/cs50victor--claude-code-teams-mcp)

HTML

<a href="/listings/cs50victor--claude-code-teams-mcp"><img src="/api/listings/cs50victor--claude-code-teams-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

> **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
    }
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 120 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. # claude-teams
  3. MCP server that implements Claude Code's [agent teams](https://code.claude.com/docs/en/agent-teams) protocol for any MCP client.
  4. </div>
  5. https://github.com/user-attachments/assets/531ada0a-6c36-45cd-8144-a092bb9f9a19
  6. 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](https://modelcontextprotocol.io/) server, making it available to any MCP client: [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [OpenCode](https://opencode.ai), or anything else that speaks MCP. Based on a [deep dive into Claude Code's internals](https://gist.github.com/cs50victor/0a7081e6824c135b4bdc28b566e1c719). PRs welcome.
  7. ## Install
  8. > **Pin to a release tag** (e.g. `@v0.1.1`), not `main`. There are breaking changes between releases.
  9. Claude Code (`.mcp.json`):
  10. ```json
  11. {
  12. "mcpServers": {
  13. "claude-teams": {
  14. "command": "uvx",
  15. "args": ["--from", "git+https://github.com/cs50victor/claude-code-teams-mcp@v0.1.1", "claude-teams"]
  16. }
  17. }
  18. }
  19. ```
  20. OpenCode (`~/.config/opencode/opencode.json`):
  21. ```json
  22. {
  23. "mcp": {
  24. "claude-teams": {
  25. "type": "local",
  26. "command": ["uvx", "--from", "git+https://github.com/cs50victor/claude-code-teams-mcp@v0.1.1", "claude-teams"],
  27. "enabled": true
  28. }
  29. }
  30. }
  31. ```
  32. ## Requirements
  33. - Python 3.12+
  34. - [tmux](https://github.com/tmux/tmux)
  35. - At least one coding agent on PATH: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (`claude`) or [OpenCode](https://opencode.ai) (`opencode`)
  36. - OpenCode teammates require `OPENCODE_SERVER_URL` and the `claude-teams` MCP connected in that instance
  37. ## Configuration
  38. | Variable | Description | Default |
  39. |----------|-------------|---------|
  40. | `CLAUDE_TEAMS_BACKENDS` | Comma-separated enabled backends (`claude`, `opencode`) | Auto-detect from connecting client |
  41. | `OPENCODE_SERVER_URL` | OpenCode HTTP API URL (required for opencode teammates) | *(unset)* |
  42. | `USE_TMUX_WINDOWS` | Spawn teammates in tmux windows instead of panes | *(unset)* |
  43. Without `CLAUDE_TEAMS_BACKENDS`, the server auto-detects the connecting client and enables only its backend. Set it explicitly to enable multiple backends:
  44. ```json
  45. {
  46. "mcpServers": {
  47. "claude-teams": {
  48. "command": "uvx",
  49. "args": ["--from", "git+https://github.com/cs50victor/claude-code-teams-mcp@v0.1.1", "claude-teams"],
  50. "env": {
  51. "CLAUDE_TEAMS_BACKENDS": "claude,opencode",
  52. "OPENCODE_SERVER_URL": "http://localhost:4096"
  53. }
  54. }
  55. }
  56. }
  57. ```
  58. ## Tools
  59. | Tool | Description |
  60. |------|-------------|
  61. | `team_create` | Create a new agent team (one per session) |
  62. | `team_delete` | Delete team and all data (fails if teammates active) |
  63. | `spawn_teammate` | Spawn a teammate in tmux |
  64. | `send_message` | Send DMs, broadcasts (lead only), shutdown/plan responses |
  65. | `read_inbox` | Read messages from an agent's inbox |
  66. | `read_config` | Read team config and member list |
  67. | `task_create` | Create a task (auto-incrementing ID) |
  68. | `task_update` | Update task status, owner, dependencies, or metadata |
  69. | `task_list` | List all tasks |
  70. | `task_get` | Get full task details |
  71. | `force_kill_teammate` | Kill a teammate's tmux pane/window and clean up |
  72. | `process_shutdown_approved` | Remove teammate after graceful shutdown |
  73. ## Architecture
  74. - **Spawning**: Teammates launch in tmux panes (default) or windows (`USE_TMUX_WINDOWS`). Each gets a unique agent ID and color.
  75. - **Messaging**: JSON inboxes at `~/.claude/teams/<team>/inboxes/`. Lead messages anyone; teammates message only lead.
  76. - **Tasks**: JSON files at `~/.claude/tasks/<team>/`. Status tracking, ownership, and dependency management.
  77. - **Concurrency**: Atomic writes via `tempfile` + `os.replace`. Cross-platform file locks via `filelock`.
  78. ```
  79. ~/.claude/
  80. ├── teams/<team>/
  81. │ ├── config.json
  82. │ └── inboxes/
  83. │ ├── team-lead.json
  84. │ ├── worker-1.json
  85. │ └── .lock
  86. └── tasks/<team>/
  87. ├── 1.json
  88. ├── 2.json
  89. └── .lock
  90. ```
  91. ## License
  92. [MIT](./LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.