# Teamhood

Connect an assistant to Teamhood to work with tasks, comments and time records. A separate endpoint limits access to read-only tools.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: teamhooddev
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/teamhooddev/teamhood-mcp
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/mcp/teamhood

## What it does

Teamhood hosts the server, so there is no local process to start. Once signed in, the assistant works in the organization you chose and uses your role’s permissions. In Claude Code, add the remote server and then sign in to Teamhood.

The assistant can search for and edit work items, connect dependent items, manage comments and time entries, and inspect item history and attachments. It can also read team members and working hours. The `/readonly` endpoint exposes reading tools only; changes require the regular endpoint and sufficient permissions. Deleted items remain recoverable from the trash for 30 days.

## Requirements
- Remote server: `https://api.teamhood.com/public/v1/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http teamhood https://api.teamhood.com/public/v1/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add teamhood --url https://api.teamhood.com/public/v1/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "teamhood": {
            "url": "https://api.teamhood.com/public/v1/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "teamhood": {
            "type": "http",
            "url": "https://api.teamhood.com/public/v1/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http teamhood https://api.teamhood.com/public/v1/mcp
```

## When to use it
- find an item and inspect its fields
- create work items and link dependencies
- add comments or correct time entries
- check team members and planned hours

## Example prompts
- Find the tasks for the current release and show their dependencies.
- Create a bug-fix task and add a comment with the proposed plan.
- Show the time entries for this item and correct the latest one.

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44908
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22082
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12826
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9623
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2330
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2071

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md