Tools in this category
| Tool | Mutating | Description |
|---|---|---|
list_projects |
no | List projects with optional status, search, date-range, and pagination filters. Use rangeStart/rangeEnd to filter projects whose [startDate, endDate] span overlaps a calendar range, or undatedOnly for projects with no dates. Default page size 20, max 50. |
get_project |
no | Fetch a single project by UUID or display ID (e.g. "P-7"), including its status, client, dates, and description. |
create_project |
yes | Create a new project. Use list_project_statuses first to get a valid statusId. |
update_project |
yes | Update a project. Only the supplied fields change; omit a field to leave it untouched. Logged in the MCP audit trail. |
delete_project |
yes | Delete a project by UUID or display ID. Cascades to dependent records (tasks become unassigned). Logged in the MCP audit trail. |
list_projects
Mutating: no
List projects with optional status, search, date-range, and pagination filters. Use rangeStart/rangeEnd to filter projects whose [startDate, endDate] span overlaps a calendar range, or undatedOnly for projects with no dates. Default page size 20, max 50.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
page |
number | no | Page number (default: 1) |
limit |
number | no | Items per page (default: 20, max: 50) |
status |
string | no | Filter by statusId |
search |
string | no | Search in name and description |
rangeStart |
string | no | Optional ISO 8601 lower bound: include projects whose [startDate, endDate] span overlaps the range. |
rangeEnd |
string | no | Optional ISO 8601 upper bound (use together with rangeStart). |
undatedOnly |
boolean | no | Only projects with no startDate and no endDate |
get_project
Mutating: no
Fetch a single project by UUID or display ID (e.g. "P-7"), including its status, client, dates, and description.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | Project ID — accepts UUID or display ID (e.g. "P-7") |
create_project
Mutating: yes
Create a new project. Use list_project_statuses first to get a valid statusId.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
name |
string | yes | Project name |
status |
string | yes | Status ID from list_project_statuses |
description |
string | no | Optional description |
startDate |
string | no | ISO 8601 start date (optional) |
endDate |
string | no | ISO 8601 end date (optional) |
clientDisplayIds |
array | no | Optional client display IDs to link (e.g. ["C-1", "C-2"]). A project can belong to multiple clients. |
update_project
Mutating: yes
Update a project. Only the supplied fields change; omit a field to leave it untouched. Logged in the MCP audit trail.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | Project ID — accepts UUID or display ID (e.g. "P-7") |
name |
string | no | Project name. |
status |
string | no | Status ID from list_project_statuses |
description |
string | no | Free-form project description; markdown supported. |
startDate |
string | no | ISO 8601 date, or empty string to clear |
endDate |
string | no | ISO 8601 date, or empty string to clear |
clientDisplayIds |
array | no | Full set of client display IDs to link; replaces existing client links. Pass [] to detach from all clients. Use link_project_to_clients / unlink_project_from_client for incremental changes. |
delete_project
Mutating: yes
Delete a project by UUID or display ID. Cascades to dependent records (tasks become unassigned). Logged in the MCP audit trail.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | Project ID — accepts UUID or display ID (e.g. "P-7") |