Integration · Projects & tasks

Connect Claude & ChatGPT to Teamhood

Ask your AI what is on a board, what a colleague is working on or how much time was logged last week. It can find items by board, status, assignee, tags or dates, and read their details and attachments. It can also create and update items, add rows to a board, and list board activity and time logs across your workspace.

Connect Teamhood free

Free plan, no credit card. Takes about a minute.

Try asking

“What is assigned to Mette on the Website board that is not done yet?”
The AI finds the board and the user, then lists the open items assigned to her with status and dates.
“Create a card on the Launch board: Update pricing page, due Friday, assigned to Tom.”
It looks up the board's rows, statuses and users, then creates the item in the right row and status with the due date and assignee.
“How much time did the design team log last week?”
It lists the time logs in the workspace for that date range, filtered by the users you name.

What your AI can do

Items

Find items by workspace, board, row, status, assignee, owner, tags or dates, read their details and attachments, and create or update them.

Boards and workspaces

List workspaces, boards, rows and statuses, and add rows to a board.

Time and activity

List logged time by date range, user, board, row or tag, and see item activity on a board.

“Move item 41822 to In review.”
It finds the board's statuses and updates the item with the new status.
“What changed on the Q3 roadmap board since Monday?”
It lists the item activity on the board between the two dates.
“Add a row called Mobile app to the Product board.”
It adds a new row (swimlane) with that title to the board.

16 tools for Teamhood

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

create_itemChanges dataCreate an item (card) with `title`, `board_id`, `row_id`, `status_id` and optional description, assignee, dates, budget and estimate. Also required: `tags`, `waiting`, `blocking`, `custom_fields` (pass empty lists if none), `milestone` and `is_suspended` (usually false) and `suspend_reason` (empty text).
create_rowChanges dataAdd a row (swimlane) to a board with `title` and `board_id`, optionally with start and end dates.
delete_itemDeletesPermanently delete an item by `product_id`. This cannot be undone.
get_attachmentGet an attachment's details by `document_id`.
get_itemGet one item (card) by `product_id` (the item ID), with title, description, status, dates and assignee.
get_workspaceGet one workspace by `workspace_id`.
list_board_activityChanges dataList item activity on a board by `board_id` between `start_date` and `end_date`, paged with `limit` and `offset`.
list_board_rowsList the rows (swimlanes) of a board by `board_id`, with their IDs.
list_board_statusesList the statuses (columns) of a board by `board_id`, with their IDs.
list_boardsList the boards in a workspace by `workspace_id`.
list_item_attachmentsList the attachments on an item by `item_id`.
list_itemsFind items (cards), filtered by `workspace_id`, `board_id`, `row_id`, `status_id`, `assigned_user_id`, `owner_id`, `tags`, `completed` or modified/created dates. Paged with `take` and `offset`.
list_timelogsChanges dataList logged time in a workspace between `start_date` and `end_date`, optionally filtered by users, boards, rows or tags.
list_usersList the users in your Teamhood organization, to find IDs for assigning items.
list_workspacesList all Teamhood workspaces you can access, with their IDs.
update_itemChanges dataUpdate an item by `product_id`; put the fields to change in `data` (same fields as create_item, e.g. title, description).

Set up in three steps

1
Pick the app
Create a free PipMCP account and choose Teamhood from the app list.
2
Paste your key
Paste your Teamhood tenant name and API key. In the Teamhood web app, open your integration settings page and copy the open API key. The tenant name is your organization's Teamhood name, the "acme" in api-acme.teamhood.com.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Teamhood?

It can list workspaces, boards, rows, statuses and users, find and read items and their attachments, and list board activity and time logs. It can create and update items, add rows to boards and delete items.

Does the AI see my Teamhood API key?

No. Your Teamhood API key is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start read-only. Deleting an item is permanent, and it and other changes can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT, open Settings › Apps & Connectors › Advanced, turn on Developer mode and add your PipMCP link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

PipMCP has a free plan, and you do not need a credit card to start. Paid plans are billed per completed task. You also need your own Teamhood account.

What is the tenant name?

Your Teamhood API address is api-<tenant>.teamhood.com, where the tenant is your organization's Teamhood name. If your address is api-acme.teamhood.com, the tenant name is acme. You enter it next to your API key.