Tools - Projects

Tools for listing, querying, creating, and updating projects.

---

list_projects

Lists all projects with optional pagination. If a projectId is configured in the MCP session, it returns only that project.

Parameters:

Name	Type	Required	Description
page	number	No	Page number (default: 1)
limit	number	No	Items per page (default: 50, max: 100)

Example:

{
  "page": 1,
  "limit": 10
}

Response:

{
  "projects": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "My Project",
      "description": "Project description",
      "status": "active",
      "createdAt": "2025-01-15T10:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "totalPages": 1
  }
}

---

get_project

Retrieves a project by its ID, including associated boards, doc links, and notes.

Parameters:

Name	Type	Required	Description
id	string (UUID)	Yes	Project ID

Example:

{
  "id": "550e8400-e29b-41d4-a716-446655440000"
}

Response:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My Project",
  "description": "Project management platform",
  "status": "active",
  "boards": [],
  "docLinks": [],
  "notes": [],
  "createdAt": "2025-01-15T10:00:00.000Z",
  "updatedAt": "2025-01-20T14:30:00.000Z"
}

---

create_project

Creates a new project. The name is required.

Parameters:

Name	Type	Required	Description
name	string	Yes	Project name
description	string	No	Project description
status	string	No	Project status: active, archived, on_hold

Example:

{
  "name": "New Project",
  "description": "Internal management app",
  "status": "active"
}

Response:

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "New Project",
  "description": "Internal management app",
  "status": "active",
  "createdAt": "2025-02-01T09:00:00.000Z"
}

---

update_project

Updates the fields of an existing project. Only the provided fields are updated.

Parameters:

Name	Type	Required	Description
id	string (UUID)	Yes	ID of the project to update
name	string	No	New name
description	string	No	New description
status	string	No	New status: active, archived, on_hold

Example:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "archived"
}

Response:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My Project",
  "description": "Project management platform",
  "status": "archived",
  "updatedAt": "2025-02-10T16:00:00.000Z"
}

---

get_project_roadmap

Retrieves the project roadmap with a hierarchical structure (epics, features, stories/tasks) and dates computed from work item activity.

Dates are computed from column movement events on the board:

• startDate: when an item was first moved to an active column
• endDate: when it was moved to a "done" column
• Parent items aggregate dates from their children

Parameters:

Name	Type	Required	Description
projectId	string (UUID)	Yes	Project ID (falls back to the MCP session ID)

Example:

{
  "projectId": "550e8400-e29b-41d4-a716-446655440000"
}

Response:

{
  "projectId": "550e8400-e29b-41d4-a716-446655440000",
  "items": [
    {
      "id": "...",
      "taskId": "A-E-1",
      "title": "Epic: Authentication",
      "type": "epic",
      "startDate": "2025-01-20T10:00:00.000Z",
      "endDate": null,
      "children": [
        {
          "id": "...",
          "taskId": "A-F-3",
          "title": "Feature: Google Login",
          "type": "feature",
          "startDate": "2025-01-20T10:00:00.000Z",
          "endDate": "2025-01-25T18:00:00.000Z",
          "children": []
        }
      ]
    }
  ]
}

Recommended usage

get_project_roadmap is ideal for AI agents to get an overview of the project state before planning new work.