list_projects

Management

List Projects

List projects within a specific team. Use this after list_teams when an OAuth workflow needs a project_id. Args: - team_id: required — team to list projects for - response_format: optional — 'json' (default) or 'markdown' Returns: the projects available in the given team. If multiple projects are returned, ask the user which project to use before calling write or generation tools. Examples: - "Show projects for this team" -> team_id="<team_id from list_teams>" - "Pick a project before run_model" -> call list_projects after the user confirms the team Don't use when: You do not know the team yet. Use list_teams first.

read-onlyidempotentopen-world

Parameters

Name	Type	Required	Description
team_id	string	—	Team ID. Required from list_teams before listing projects.
response_format	enum(json \| markdown)	json	Output format: 'json' for structured data, 'markdown' for human-readable text.

Example Request

JSON

{
  "team_id": "team_abc123"
}

Example Response

JSON

{
  "projects": [
    {
      "id": "proj_xyz789",
      "name": "Fantasy RPG"
    }
  ]
}

Common Use Cases

Find project IDs for a selected team before using OAuth-protected tools
Confirm whether a team has multiple projects and prompt the user to choose one