Teamhood — Claude Code MCP server: features and setup
Connect an assistant to Teamhood to work with tasks, comments and time records. A separate endpoint limits access to read-only tools.
claude mcp add --transport http teamhood https://api.teamhood.com/public/v1/mcpWhat Teamhood 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.
What it helps with
- 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 for the agent
- 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.
How to install Teamhood
Platform CLI: remote server
claude mcp add --transport http teamhood https://api.teamhood.com/public/v1/mcpPlatform CLI: remote server
codex mcp add teamhood --url https://api.teamhood.com/public/v1/mcpConfig file
{
"mcpServers": {
"teamhood": {
"url": "https://api.teamhood.com/public/v1/mcp"
}
}
}Config file
{
"servers": {
"teamhood": {
"type": "http",
"url": "https://api.teamhood.com/public/v1/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http teamhood https://api.teamhood.com/public/v1/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Teamhood
How do I install Teamhood in Claude Code?
Run claude mcp add --transport http teamhood https://api.teamhood.com/public/v1/mcp, then run claude mcp login teamhood and sign in to Teamhood.
What does the Teamhood MCP server do?
It lets an assistant read and update Teamhood items, comments and time records using the connected user’s permissions.
Can I connect Teamhood in read-only mode?
Yes. Use https://api.teamhood.com/public/v1/mcp/readonly; that endpoint exposes reading tools only.
