Teamhood
Teamhood project management for matrix organizations: items, dependencies, time, capacity and teams.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http teamhood 'https://api.teamhood.com/public/v1/mcp'
{
"mcpServers": {
"teamhood": {
"type": "http",
"url": "https://api.teamhood.com/public/v1/mcp"
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
Teamhood MCP server
Connect Claude, ChatGPT, Copilot, Cursor, VS Code or any other assistant that supports the Model Context Protocol to Teamhood, the project management tool for matrix organizations. The assistant reads and updates your work as you, with your role's permissions.
The server is hosted by Teamhood: there is nothing to install or run. This repository holds its listing for the MCP Registry and this guide. Full documentation is at help.teamhood.com.
Addresses
| Address | Offers |
|---|---|
https://api.teamhood.com/public/v1/mcp | Every tool |
https://api.teamhood.com/public/v1/mcp/readonly | Only the tools that read |
The address is the same for every organization: signing in decides which organization the assistant works in. Both use the Streamable HTTP transport.
Connect an assistant
| Assistant | How |
|---|---|
| Claude, ChatGPT and others | Add a custom connector, or a remote MCP server, with the address |
| Claude Code | claude mcp add --transport http teamhood https://api.teamhood.com/public/v1/mcp, then claude mcp login teamhood |
| Cursor | In .cursor/mcp.json: {"mcpServers": {"teamhood": {"url": "https://api.teamhood.com/public/v1/mcp"}}} |
| VS Code | In .vscode/mcp.json: {"servers": {"teamhood": {"type": "http", "url": "https://api.teamhood.com/public/v1/mcp"}}} |
The assistant then asks you to sign in to Teamhood and approve it. Step by step: Connect an assistant with MCP.
Signing in
- OAuth. The assistant opens Teamhood's sign-in page, and you approve it for one organization. Disconnect it any time under Settings → Integrations → MCP → Connected apps.
- Personal token. For an assistant that takes a request header instead, create a token under Settings → Personal tokens and send it in the
X-Api-Keyheader or asAuthorization: Bearer <token>.
What an assistant can do
- Read the item types, their fields and the values each field allows
- Find, read, create, change and delete items, and link items that depend on each other
- Read, post, edit and delete comments; read, log, correct and delete time
- Read an item's history, and the images and text files attached to it
- Read working hours, time off and planned hours, and list the people and teams
- Change item types, fields, teams and invitations, through a connection allowed to
- Search Teamhood's help pages
Every tool and its limits: MCP server reference.
Safety
- An assistant acts as the person who connected it, and can do only what that person's role allows.
- The read-only address never offers a tool that changes anything.
- Changes to the organization's setup need a connection you approved for them, or a personal token.
- A deleted item goes to the trash, where it can be restored for 30 days.
- Changes to an item's title, description and fields show in its activity under your name with the AI label. Comments it posts carry the same label.
More: How MCP works in Teamhood.
Teamhood skill
Assistants that load skills can add the Teamhood skill, which gives them the rules for working in Teamhood. See Add the Teamhood skill to an assistant.
Support
Choose Contact us at the bottom of the Help panel in Teamhood (how). Privacy policy: teamhood.com/privacy-policy.
Publishing the registry listing
The listing is server.json, published as com.teamhood/teamhood. The registry proves ownership of teamhood.com from a TXT record on the domain's apex: v=MCPv1; k=ed25519; p=<public key>. The matching private key is the repository secret MCP_PRIVATE_KEY, as 64 hex characters.
To change the listing, edit server.json, raise its version (a published version cannot be replaced), and run the Publish to MCP Registry workflow.
Questions fréquentes
Qu'est-ce que Teamhood ?
Teamhood project management for matrix organizations: items, dependencies, time, capacity and teams.
Comment installer Teamhood ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http teamhood 'https://api.teamhood.com/public/v1/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Teamhood ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
Teamhood est-il open source ?
Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.
Qui maintient Teamhood ?
Il est publié par teamhooddev. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.