list_usersLABSCO SUMMARY
The reporting tools are the reason to install it.
CRUD over teams and users is convenient; the seven report tools are the part you cannot easily replicate, because they return TeamRetro's own computed statistics — participation rates, overdue actions bucketed by age, historical health scores per dimension — as CSV a model can summarise directly. Because it tracks the public API, a change on TeamRetro's side can change what these return.
What it is
A community-built server over TeamRetro's public API, covering the platform broadly rather than one corner of it. Alongside CRUD for teams, users and their retrospective artefacts, it exposes TeamRetro's reporting endpoints, which return CSV — that is where the analytical value sits, since those reports are hard to assemble by hand.
What you get
- Users:
list_users,get_user,add_user,update_user,delete_user, all keyed by email address - Teams and members:
list_teams,detail_team,create_team,update_team,delete_team, pluslist_team_members,get_team_member,add_team_member,update_team_member,remove_team_member - Actions:
list_actions,create_action,get_action,update_action,delete_actionwith due date, completion, priority and assignee - Agreements:
list_agreements,create_agreement,get_agreement,update_agreement,delete_agreement - Health:
list_health_checks,get_health_check,delete_health_check,list_health_models,get_health_model - Retrospectives:
list_retrospectives,get_retrospective,delete_retrospective - Reports as CSV:
team_activity_report,team_actions_activity_reportwith open/completed/overdue counts by age range,retrospective_activity_reportandhealth_check_activity_reportwith participation rates and idea, comment, action and agreement counts,team_health_latest_reportandteam_health_historical_reportby health model, andusers_reportwith roles, memberships and activity - Filtering by team tags and team IDs, and offset/limit pagination, on the list endpoints
Requirements
A TeamRetro API key, set as TEAMRETRO_API_KEY with TEAMRETRO_AUTH_TYPE set to apiKey. TEAMRETRO_BASE_URL defaults to https://api.teamretro.com and only needs setting if yours differs. Run it through npx from the published teamretro-mcp-server package, or build from source with pnpm install and pnpm run build. Package teamretro-mcp-server, version 0.12.6. This is a community project, not built or endorsed by TeamRetro.
Setup effort
Build from source — git clone https://github.com/adepanges/teamretro-mcp-server.git
USE CASES
01
Finding out which actions are overdue
Pull the actions report and get open, completed and overdue counts grouped by age range instead of counting by hand.
02
Checking whether retros are actually being attended
Run the retrospective activity report over a date range and read participation, idea and comment counts.
03
Tracking a team's health over time
Compare the latest health scores against the historical report for the same model.
04
Setting up a new squad
Create the team, add the members by email, and record the agreements in the same conversation.
40 tools
Listed in project docs. Your client may show a different list.
add_userupdate_userdelete_userget_userlist_teamsdetail_teamupdate_teamcreate_teamdelete_teamlist_team_membersget_team_memberupdate_team_memberremove_team_memberadd_team_memberlist_actionscreate_actionget_actionupdate_actiondelete_actionlist_agreementscreate_agreementget_agreementupdate_agreementdelete_agreementlist_health_checksget_health_checkdelete_health_checklist_health_modelsget_health_modellist_retrospectivesget_retrospectivedelete_retrospectiveteam_activity_reportteam_actions_activity_reportretrospective_activity_reporthealth_check_activity_reportteam_health_latest_reportteam_health_historical_reportusers_reportBEFORE YOU INSTALL
What to know first
Tools you get
40 tools named in the project's documentation. The seven *_report tools return CSV rather than JSON.
Requires
- npx on PATH
- TEAMRETRO_API_KEY in your environment
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/adepanges/teamretro-mcp-server.git
cd teamretro-mcp-server
pnpm install
pnpm run buildpoint the client at node <YOUR_PATH_TO_TEAMRETRO_MCP_SERVER>/dist/index.js
MCP Clients
Any MCP client — npx
ANY MCP CLIENT — NPX · JSON
{
"mcpServers": {
"teamretro-mcp-server": {
"command": "npx",
"args": [
"-y",
"teamretro-mcp-server"
],
"env": {
"TEAMRETRO_AUTH_TYPE": "apiKey",
"TEAMRETRO_API_KEY": "<YOUR_TEAMRETRO_API_KEY>"
}
}
}
}Any MCP client — Local build
ANY MCP CLIENT — LOCAL BUILD · JSON
{
"mcpServers": {
"teamretro-mcp-server": {
"command": "node",
"args": [
"<YOUR_PATH_TO_TEAMRETRO_MCP_SERVER>/dist/index.js"
],
"env": {
"TEAMRETRO_AUTH_TYPE": "apiKey",
"TEAMRETRO_API_KEY": "<YOUR_TEAMRETRO_API_KEY>"
}
}
}
}MCP Inspector
MCP INSPECTOR · TERMINAL
pnpm run inspector
