Integration · Productivity

Connect Claude & ChatGPT to TeamRetro

Ask your AI what came out of the last retrospective, which action items are overdue, or how a team's health check looked. It reads retrospective reports and summaries, ideas, actions, agreements and health checks, and can search across all your retros. It can also create retrospectives, health checks, actions and agreements and add ideas and comments.

Connect TeamRetro free

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

Try asking

“Summarize the Platform team's last retrospective.”
The AI finds the team and its latest retrospective and reads the written summary.
“Which action items are overdue, and who owns them?”
It lists overdue actions across your teams with their assignees and due dates.
“Have we talked about flaky tests in any retro this year?”
It searches ideas, comments and actions across retrospectives for the topic and date period.

What your AI can do

Retrospectives

Create and update retros, add ideas and comments, and read ideas, full reports and summaries.

Actions and agreements

List, create and update action items with owners, priority and due dates, and keep team agreements.

Health checks and search

Create health checks, read their summaries, and search ideas, comments and actions across all retros.

“Set up next Thursday's retro for the Mobile team with our usual template.”
It lists templates and creates the retrospective for the team with the name, date and template.
“How did the Data team's latest health check look?”
It finds the health check and reads its written summary.
“Mark the action 'Update the runbook' as done.”
It updates the action item and sets its completed date.

92 tools for TeamRetro

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

add_commentChanges dataAdd a comment to an idea, action, agreement, group or estimation item (`target_type`, `target_id`) with `text`; reply by passing `parent_comment_id`. People listed in `mentions` are notified.
approve_group_suggestionVisible to othersAccept a group suggestion (retrospective id). Has effects visible outside this system. API summary: Accept Group Suggestions.
capture_ideaChanges dataCapture an idea for a team (`team_id`) with a `title`, optionally into a specific retrospective and topic.
create_actionChanges dataCreate an action item for a team (`team` with its id) with a `title`, optional `due` date, `priority` and `assigned_to` emails. People listed in `mentions` are notified.
create_agreementChanges dataCreate a team agreement for a team (`team` with its id) with a `title`.
create_auto_suggestChanges dataCreate a new auto suggest. API summary: Suggest Groups.
create_estimationChanges dataCreate a new estimation. API summary: Create Estimation.
create_estimation_productChanges dataCreate a new product for a estimation. Required: items. Search products first to avoid duplicates. API summary: Add Estimation Items.
create_feature_requestChanges dataCreate a new feature request. Required: capability. API summary: Send a feature request.
create_health_checkChanges dataCreate a health check for a team (`team_id`) with a `name`, `date` and either a `health_model_id` or `use_last_health_model`.
create_retrospectiveChanges dataCreate a retrospective for a team (`team_id`) with a `name`, `date` and either a `template_id` or custom `topics` (columns).
create_retrospective_group_suggestionChanges dataCreate a new group suggestion for a retrospective. Required: suggestions. API summary: Add Group Suggestions.
create_standup_updateChanges dataCreate a new update for a standup. API summary: Create Standup Updates.
create_teamChanges dataCreate a new team. Required: name. API summary: Create a Team.
create_team_productChanges dataCreate a new product for a team. Required: title. Search products first to avoid duplicates. API summary: Create Parked Item.
create_team_standupChanges dataCreate a new standup for a team. Required: topics. API summary: Create a Standup Series.
delete_actionDeletesPermanently delete an action item by `action_id`. This cannot be undone.
delete_agreementDeletesPermanently delete a agreement by agreement id. Destructive action; may require approval. API summary: Delete Agreement.
delete_estimationDeletesPermanently delete a estimation by estimation id. Destructive action; may require approval. API summary: Delete Estimation.
delete_health_checkDeletesPermanently delete a health check by health check id. Destructive action; may require approval. API summary: Delete Health Check.
delete_kudoDeletesPermanently delete a kudo by kudos id. Destructive action; may require approval. API summary: Delete Kudos.
delete_messageDeletesPermanently delete a message by message id. Destructive action; may require approval. API summary: Delete Comment.
delete_retrospectiveDeletesPermanently delete a retrospective by retrospective id. Destructive action; may require approval. API summary: Delete Retrospective.
delete_retrospective_group_suggestionDeletesPermanently delete a group suggestion by suggestion id. Destructive action; may require approval.
delete_retrospective_ideaDeletesPermanently delete a idea by idea id. Destructive action; may require approval. API summary: Delete A Retrospective Idea.
delete_retrospective_voteDeletesPermanently delete a vote by target id. Destructive action; may require approval. API summary: Remove A Vote From A Retrospective Idea Or Group.
delete_standup_updatesMoves moneyPermanently delete a update by standup series id. Financial or irreversible action; may require approval. API summary: Delete Standup Updates.
delete_teamDeletesPermanently delete a team by team id. Destructive action; may require approval. API summary: Delete Team.
delete_team_productDeletesPermanently delete a product by product id. Destructive action; may require approval. API summary: Delete Parked Item.
delete_team_userDeletesPermanently delete a user by email. Destructive action; may require approval. API summary: Remove Team Member.
delete_userDeletesPermanently delete a user by email. Destructive action; may require approval. API summary: Delete User.
export_meetings_linksExport meetings. API summary: Get Meeting Export Links.
get_actionGet one action item by `action_id`.
get_agreementGet one agreement by agreement id. API summary: Get Agreement.
get_estimationGet one estimation by estimation id. API summary: Get Estimation.
get_health_checkGet one health check by `health_check_id`.
get_health_check_summaryGet a written summary of a health check by `health_check_id` (Markdown).
get_health_modelGet one health model by health model id. API summary: Get Health Model.
get_productGet one product by product id. API summary: Get a help article.
get_retrospectiveGet one retrospective by `retrospective_id`, with its topics, phase and status.
get_retrospective_reportGet the full report of a retrospective by `retrospective_id` (Markdown), optionally including comments.
get_retrospective_summaryGet a written summary of a retrospective by `retrospective_id` (Markdown).
get_teamGet one team by `team_id`, with its name, tags and settings.
get_team_productGet one product for a team by product id. API summary: Get Parked Item.
get_team_userGet one user for a team by email. API summary: Get Team Member.
get_templateGet one template by template id. API summary: Get Template.
get_userGet one user by email. API summary: Get User.
list_accountsList accounts. Optional filters: metric, team ids, team tags, health model ids, date from or date to. API summary: Insights — Account-wide (Unified).
list_actionsList action items, filtered by `team_ids`, `status`, `overdue`, `meeting_id` or `assigned_to`.
list_agreementsList team agreements, filtered by `team_ids` or `team_tags`.
list_estimation_report_mdsList report mds for a estimation. Optional filters: comments. API summary: Get Estimation Markdown Report.
list_estimationsList estimations. Optional filters: team ids, team tags, date from, date to or sort. Results are paginated.
list_health_check_dimensionsList dimensions for a health check. Optional filters: sort or dimension group ids. Results are paginated.
list_health_check_report_mdsList report mds for a health check. Optional filters: comments. API summary: Get Health Check Markdown Report.
list_health_checksList team health checks, filtered by `team_ids`, `health_model_ids` or a date range.
list_health_modelsList health models you can use when creating a health check.
list_health_team_health_historicalsList team health historicals for a health. Optional filters: team ids, team tags, date from or date to. API summary: Team Health (Historical) Report.
list_health_team_health_latestsList team health latests for a health. Optional filters: team ids, team tags, date from or date to. API summary: Team Health (Latest) Report.
list_retrospective_group_suggestionsList group suggestions for a retrospective. Optional filters: status.
list_retrospective_ideasList the ideas posted in a retrospective by `retrospective_id`, optionally filtered by topic or group.
list_retrospective_templatesList retrospective templates you can use when creating a retrospective.
list_retrospectivesList retrospectives, filtered by `team_ids`, `team_tags` or a date range (`date_from`, `date_to`).
list_standup_updatesList updates for a standup. Optional filters: date. Results are paginated. API summary: Get Standup.
list_tasksList tasks. Optional filters: team ids or team tags. API summary: Team Activity Report.
list_tasks_v1_get_reports_team_actions_activityList tasks. Optional filters: team ids or team tags. API summary: Team Actions Activity Report.
list_tasks_v1_get_reports_team_health_check_activityList tasks. Optional filters: team ids, team tags, date from or date to. API summary: Health Check Activity Report.
list_tasks_v1_get_reports_team_retrospective_activityList tasks. Optional filters: team ids, team tags, date from or date to. API summary: Retrospective Activity Report.
list_team_membersList the members of a team by `team_id`.
list_team_productsList products for a team. Optional filters: date from, date to or sort. Results are paginated. API summary: List Parked Items.
list_team_reportsList reports for a team. Optional filters: type, date from, date to, sort or comments. Results are paginated. API summary: List Team Reports (Batch).
list_team_standupsList standups for a team. API summary: List Standup Series.
list_teamsList your TeamRetro teams with their IDs, optionally filtered by `team_ids` or `team_tags`. Most other tools need a team ID from here.
list_usersList the users in your TeamRetro organization.
list_users_v1_get_reports_usersList users. Optional filters: team ids or team tags. API summary: Users Report.
reject_group_suggestionVisible to othersReject a group suggestion (retrospective id). Has effects visible outside this system. API summary: Reject Group Suggestions.
search_productsSearch products by query. Use this to find existing products before creating a new product. API summary: List help articles.
search_retrospectivesChanges dataSearch ideas, comments and actions across retrospectives with `query_text`; narrow by `team_ids`, `sentiment`, author `user_id` or a date period.
update_actionChanges dataUpdate an action item by `action_id`: title, due date, priority, assignees, or set `completed` to a date to mark it done. Only the fields you pass change.
update_agreementChanges dataUpdate a team agreement by `agreement_id`: its title or team. Only the fields you pass change.
update_dimension_messagesVisible to othersUpdate an existing message identified by dimension id. Has effects visible outside this system. API summary: Add Feedback To A Health Check Dimension.
update_estimationChanges dataUpdate an existing estimation identified by estimation id. Only the fields you pass are changed. API summary: Update Estimation.
update_estimation_voteChanges dataUpdate an existing vote identified by estimation item id. API summary: Submit An Estimate For An Item.
update_health_checkChanges dataUpdate an existing health check identified by health check id. Only the fields you pass are changed. API summary: Update Health Check.
update_kudoChanges dataUpdate an existing kudo identified by target id. API summary: Create Kudos.
update_retrospectiveChanges dataUpdate a retrospective by `retrospective_id`: name, date, topics, or move it to another `phase`. Setting `status` to closed finalises it and sends summary notifications.
update_retrospective_group_suggestionChanges dataUpdate an existing group suggestion identified by suggestion id. Only the fields you pass are changed. API summary: Update A Group Suggestion.
update_retrospective_ideaChanges dataUpdate an existing idea identified by idea id. Only the fields you pass are changed. API summary: Update A Retrospective Idea.
update_retrospective_voteChanges dataUpdate an existing vote identified by target id. API summary: Vote For A Retrospective Idea Or Group.
update_teamChanges dataUpdate an existing team identified by team id. Only the fields you pass are changed. API summary: Update Team.
update_team_productChanges dataUpdate an existing product identified by product id. Only the fields you pass are changed. API summary: Update Parked Item.
update_team_userVisible to othersUpdate an existing user identified by email. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update Team Member.
update_userVisible to othersUpdate an existing user identified by email. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update User.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose TeamRetro from the app list.
2
Paste your key
Enter your TeamRetro API host, api.teamretro.com (US) or api.eu.teamretro.com (EU), and paste your API key (tra_… or trt_…). Team admins on all paid plans create a team key under Team > Settings > API. Account owners on Enterprise plans can create an account-wide key under Account > Settings > API & Connected Apps.
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 TeamRetro?

The AI can read teams, members, users, retrospectives with their ideas, reports and summaries, action items, agreements, health checks with summaries, health models and templates, and search across retro content. It can create retrospectives, health checks, actions and agreements, add ideas and comments, update retrospectives and actions, and delete action items.

Does the AI see my TeamRetro credentials?

No. Your TeamRetro 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. Closing a retrospective finalises it and sends summary notifications, and deleting an action item is permanent. Both can require your approval before they run, and every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps 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?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own TeamRetro account.

Should I use a team key or an account key?

A team key, created by a team admin under Team > Settings > API, is available on all paid plans. An account-wide key, created by the account owner under Account > Settings > API & Connected Apps, needs an Enterprise plan. Pick the US or EU API host that matches where your TeamRetro account lives.