teamretro-mcp-server MCP Server

Key features: - Complete TeamRetro API coverage with 20+ tools for managing teams, users, actions, and more - Simplified AI client integration through standardized MCP interfaces - Built-in pagination and filtering…

Local serverstdioApache-2.0

What is the teamretro-mcp-server MCP Server?

teamretro-mcp-server source profile. From the maintainer documentation: “Key features: - Complete TeamRetro API coverage with 20+ tools for managing teams, users, actions, and more - Simplified AI client integration through standardized MCP interfaces - Built-in pagination and filtering support for efficient data handling - Secure API authentication handling and environment configuration - Comprehensive documentation and easy setup options”

Installation

The documented npm package is teamretro-mcp-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares TEAMRETRO_AUTH_TYPE, TEAMRETRO_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_usersList users with pagination using offset and limit parameters to control the number of results returned
add_userAdd a new user or update an existing user's information by their email address, specifying optional name and emailAddress
update_userUpdate an existing user's details, such as their name and emailAddress, by providing their current email
delete_userDelete a user by their email address
get_userRetrieve detailed information about a single user by their email address
list_teamsList teams from TeamRetro with filtering by tags and IDs, and pagination using offset and limit parameters
detail_teamRetrieve detailed information about a single team by its unique ID
update_teamUpdate an existing team's details, such as its name and associated tags, by providing the team's ID
create_teamCreate a new team with a required name, and optional tags and members
delete_teamDelete an existing team by its ID
list_team_membersRetrieve a list of team members for a specified team ID with pagination controls for offset and limit
get_team_memberFetch a team member by their email address within a specified team
update_team_memberUpdate a team member's details, such as their name or team admin status, by their email address within a specified team
remove_team_memberRemove a team member from a team by their email address
add_team_memberAdd a new team member to a team by their email address, with optional specification of team admin status
list_actionsRetrieve a list of actions from TeamRetro with optional filtering by team tags and team IDs, and pagination controls for offset and limit
create_actionCreate a new action in TeamRetro with required details such as team ID, title, due date, completion status, and assigned user
get_actionFetch a single action by its unique ID from TeamRetro
update_actionUpdate an existing action in TeamRetro with new details such as title, due date, completion status, priority, and assigned user
delete_actionDelete an existing action from TeamRetro by its action ID
list_agreementsList agreements from TeamRetro with optional filtering by team tags and team IDs, as well as pagination controls
create_agreementCreate a new agreement in TeamRetro by specifying the team it belongs to and its title
get_agreementRetrieve a single agreement by its unique identifier
update_agreementUpdate an existing agreement's details such as its title or associated team
delete_agreementDelete an existing agreement by specifying its unique identifier
list_health_checksList health checks from TeamRetro with optional filtering by health model IDs, team tags, and team IDs, as well as pagination controls
get_health_checkRetrieve a single health check by its unique identifier with optional attributes to include
delete_health_checkDelete an existing health check by specifying its unique identifier
list_health_modelsList health models from TeamRetro with pagination controls
get_health_modelRetrieve a single health model by its unique identifier
list_retrospectivesList retrospectives from TeamRetro with filtering by team tags and IDs, and pagination using offset and limit parameters
get_retrospectiveRetrieve detailed information about a single retrospective by its unique ID
delete_retrospectiveDelete an existing retrospective by its ID
team_activity_reportGenerate a team activity report from TeamRetro with filtering by team tags and team IDs
team_actions_activity_reportGenerate a team actions activity report from TeamRetro with filtering by team tags and team IDs. Returns CSV data with action statistics including open…
retrospective_activity_reportGenerate a retrospective activity report from TeamRetro with filtering by date range, team tags and team IDs. Returns CSV data with retrospective statistics…
health_check_activity_reportGenerate a health check activity report from TeamRetro with filtering by date range, team tags and team IDs. Returns CSV data with health check statistics…
team_health_latest_reportGenerate a team health (latest) report from TeamRetro for a specific health model with filtering by date range, team tags and team IDs. Returns CSV data with…
team_health_historical_reportGenerate a team health (historical) report from TeamRetro for a specific health model with filtering by date range, team tags and team IDs. Returns CSV data…
users_reportGenerate a users report from TeamRetro with filtering by team tags and team IDs. Returns CSV data with user information including account roles, team…

How to install the teamretro-mcp-server MCP Server

{
  "mcpServers": {
    "teamretro-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "teamretro-mcp-server"
      ],
      "env": {
        "TEAMRETRO_AUTH_TYPE": "apiKey",
        "TEAMRETRO_API_KEY": "YOUR_TEAMRETRO_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
TEAMRETRO_AUTH_TYPEDeclared in the maintainer’s client configuration.Check documentation
TEAMRETRO_API_KEYDeclared in the maintainer’s client configuration.Check documentation