Tools

What this is: the 52 tools a client can call, in 12 groups, and what each needs. When you need it: choosing the scopes to approve, or checking what an agent is able to do.

Tool	Title	Kind	Scopes	What it does
Tasks 15 toolsFind, read, create and change tasks, and link them to projects, sprints, milestones, sections, subtasks and dependencies.
search_tasks	Search tasks	read-only	tasks:read	Search the organization's tasks by words in their title, description or id, optionally filtered.
list_my_tasks	List my tasks	read-only	tasks:read	List the tasks assigned to you, optionally filtered by status, priority, project or due date.
list_project_tasks	List a project's tasks	read-only	tasks:read	List the tasks of one project, optionally filtered by status, assignee, priority or due date.
list_team_tasks	List a team's unfiled tasks	read-only	teams:read	List a team's tasks that are not filed in any project (the team's List).
get_task	Get a task	read-only	tasks:read	Read one task by its id, with its description, dates, assignee, links and type fields.
create_task	Create a task	write	tasks:write	Create a task in the organization, optionally in a project, with an assignee, priority and dates. Tasks you create may be held for review before they enter a private project.
update_task	Update a task	write	tasks:write	Change a task's status, priority, assignee, dates, title, description or type; a field sent as null is cleared.
set_task_project	Move a task to a project	write	tasks:write	Move a task to another project of the organization, or take it out of its project.
set_task_sprint	File a task in a sprint	write	tasks:write	File a task in one of its team's sprints, or take it out of its sprint.
set_task_milestone	Attach a task to a milestone	write	tasks:write	Attach a task to one of its project's milestones, or detach it.
set_task_section	Place a task in a section	write	tasks:write	Place a task in a section of a project, a team or your own list, or take it out of that scope's sections.
add_subtask	Add a subtask	write	tasks:write	Link an existing task under another task as its subtask.
remove_subtask	Remove a subtask link	destructive	tasks:write	Unlink a subtask from its parent task; both tasks stay.
add_dependency	Add a dependency	write	tasks:write	Record that a task depends on another task.
remove_dependency	Remove a dependency	destructive	tasks:write	Remove a dependency between two tasks; both tasks stay.
Comments 3 toolsRead a task's discussion, comment and reply.
list_comments	List a task's comments	read-only	tasks:read	List the comments on a task, each with its replies.
add_comment	Comment on a task	write	tasks:write	Post a comment on a task.
reply_to_comment	Reply to a comment	write	tasks:write	Reply to a comment on a task.
Projects 5 toolsFind, read, create and change projects, and see who is on them.
list_projects	List projects	read-only	projects:read	List the organization's projects you can read, optionally filtered by status, priority, team or words.
get_project	Get a project	read-only	projects:read	Read one project by its id, with its owner, members, dates and progress.
create_project	Create a project	write	projects:write	Create a project in the organization; you become its owner.
update_project	Update a project	write	projects:write	Change a project's name, description, status, priority, dates, visibility or team; a field sent as null is cleared.
list_project_members	List a project's members	read-only	projects:read	List the people on a project and their project roles.
Teams 3 toolsThe organization's teams and their members.
list_teams	List teams	read-only	teams:read	List the organization's teams with their member and project counts.
get_team	Get a team	read-only	teams:read	Read one team by its id, with its members.
list_team_members	List a team's members	read-only	teams:read	List the people in a team and their team roles.
Sprints 3 toolsA team's sprints: list, create, change, complete.
list_sprints	List a team's sprints	read-only	teams:read	List a team's sprints with their dates, status and task counts.
create_sprint	Create a sprint	write	teams:write	Create a sprint for a team with a start date and an end date or a length in weeks.
update_sprint	Update a sprint	write	teams:write	Change a sprint's name, goal, dates or length, or complete it.
Milestones 3 toolsProject milestones: list one project's or the whole organization's, create, change, close.
list_milestones	List milestones	read-only	projects:read	List one project's milestones, or every milestone you can read across the organization's projects, with their target dates and progress.
create_milestone	Create a milestone	write	projects:write	Create a milestone in a project with a target date and an optional owner.
update_milestone	Update a milestone	write	projects:write	Change a milestone's title, target date, description or owner, or close / reopen it.
Goals 4 toolsProject goals, and filing tasks under them.
list_goals	List goals	read-only	projects:read	List one project's goals, or every goal you can read in the organization, with their task progress.
create_goal	Create a goal	write	projects:write	Create a goal in a project.
update_goal	Update a goal	write	projects:write	Change a goal's name, target date or description, or close / reopen it.
file_tasks_under_goal	File tasks under a goal	write	projects:write	File one or more tasks of a project under one of its goals.
Sections 3 toolsThe named sections that order a project's, a team's or your own list.
list_sections	List sections	read-only	tasks:read	List the sections of a project, a team or your own list, in order, with their task counts.
create_section	Create a section	write	tasks:write	Create a section in a project's, a team's or your own list.
update_section	Rename or move a section	write	tasks:write	Rename a section, or move it by changing its position.
Saved views 3 toolsSaved views of the task and projects lists, and the rows they show now.
list_views	List saved views	read-only	tasks:read	List the saved views you can read: your own, your projects' and your teams'.
get_view	Get a saved view	read-only	tasks:read	Read a saved view's definition: its name, which list it queries and its filters, sort and grouping.
view_rows	Show a saved view's rows	read-only	tasks:read	List the rows a saved view shows right now: tasks or projects, per the view.
Organization 3 toolsThe organization this connection acts in: its profile, its people and the designation catalog. Read-only.
get_organization	Get the organization	read-only	members:read	Read the organization this connection acts in: its name, description, owners, your role and counts.
list_org_members	List the organization's members	read-only	members:read	List the organization's members with their role, designation, whether they are active and when they were last active.
list_designations	List designations	read-only	members:read	List the designations (job titles) people in the organization can hold, flat or grouped by category.
Me 1 toolWho the connection acts as. Always on, whatever `groups` says.
whoami	Who am I	read-only	none	Show who this connection acts as: the person or service account, the organization and the granted scopes.
Admin 6 toolsoff by defaultDeletions and removals. Off unless asked for (`groups=…,admin`), and only for a token holding the `admin` scope.
delete_task	Delete a task	destructive	tasks:writeadmin	Delete a task permanently.
delete_project	Delete a project	destructive	projects:writeadmin	Delete (archive) a project.
delete_comment	Delete a comment	destructive	tasks:writeadmin	Delete a comment on a task.
remove_project_member	Remove a project member	destructive	projects:writeadmin	Remove a person from a project.
remove_team_member	Remove a team member	destructive	teams:writeadmin	Remove a person from a team.
delete_section	Delete a section - its tasks stay	destructive	tasks:writeadmin	Delete a section; its tasks are not deleted, they become unsectioned in that list.

Choosing groups

A connection gets 11 groups unless its URL names some: every group except admin. Two query parameters narrow it, and the server enforces them — a tool outside them is neither listed nor callable:

Read-only · three groups · admin asked for

https://api.taskadence.com/mcp?readonly=1
https://api.taskadence.com/mcp?groups=tasks,projects,views
https://api.taskadence.com/mcp?groups=tasks,projects,admin

readonly=1 keeps only read-only tools. groups= keeps the groups you name; me (whoami) is always on. The admin group — every deleting tool — must be named, and needs a token with the admin scope as well.

The Organization group only reads — the organization, its members and designations, with members:read (which org:read includes). Inviting, changing roles and removing people stay in the app, by design; see security.

Annotations

Every tool carries a title, readOnlyHint, destructiveHint, idempotentHint and openWorldHint (always false: every tool acts inside your organization). Clients use them to ask you before a change.

Scopes

A tool needs the scopes of the API operations it calls, shown on each card. A token without them does not see the tool. See scopes.

Every call is recorded

Each tool call writes one event to your organization’s audit log — the tool, whether it worked and the token’s name, never what was sent or returned. A task created through MCP is marked as such (created_via), so it is traceable to the connection. A task an agent creates waits for a person to review it — see security.

The tools

Tasks 15 tools

search_tasks Search tasks

What it does	Try
Search the organization's tasks by words in their title, description or id, optionally filtered.	“Find the tasks about the invoice export that are still open.”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	tasks:read	GET /v1/tasks

Argument	Type	Description
created_via	("app" | "api" | "sdk" | "mcp" | "none")[] | null	Only tasks created through these clients: app (a person in the web app), api, sdk, mcp (agents), or none (created before this was recorded)
review	("pending" | "accepted" | "rejected" | "none")[] | null	Only tasks in these review states: pending (waiting for a person), accepted, rejected, or none (never in review)
limit	integer	Page size (default 25, at most 100)
cursor	string | null	The previous page's next_cursor, echoed back unchanged
status	("backlog" | "not_started" | "in_progress" | "blocked" | "completed" | "archived" | "on_hold")[] | null	Only these statuses
priority	("critical" | "high" | "medium" | "low" | "none")[] | null	Only these priorities
task_type	("task" | "bug")[] | null	Only these kinds: task, bug
due_before	date | null	Due on or before this date (ISO)
due_after	date | null	Due on or after this date (ISO)
overdue	boolean | null	Only tasks past their due date and not completed
sort_by	"task_id" | "title" | "status" | "priority" | "due_date" | "start_date" | "created_at" | "assignee" | "project_id" | "priority_rank" | "status_rank" | "task_type" | null
sort_order	"asc" | "desc" | null
search required	string	Words to find in the title, description or id
assignee	string[] | null	Usernames, or me
project	string[] | null	Project ids, or __unfiled__ for tasks with no project
team	string[] | null	Team ids

list_my_tasks List my tasks

What it does	Try
List the tasks assigned to you, optionally filtered by status, priority, project or due date.	“What's on my plate this week?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	tasks:read	GET /v1/tasks

Argument	Type	Description
created_via	("app" | "api" | "sdk" | "mcp" | "none")[] | null	Only tasks created through these clients: app (a person in the web app), api, sdk, mcp (agents), or none (created before this was recorded)
review	("pending" | "accepted" | "rejected" | "none")[] | null	Only tasks in these review states: pending (waiting for a person), accepted, rejected, or none (never in review)
limit	integer	Page size (default 25, at most 100)
cursor	string | null	The previous page's next_cursor, echoed back unchanged
status	("backlog" | "not_started" | "in_progress" | "blocked" | "completed" | "archived" | "on_hold")[] | null	Only these statuses
priority	("critical" | "high" | "medium" | "low" | "none")[] | null	Only these priorities
task_type	("task" | "bug")[] | null	Only these kinds: task, bug
due_before	date | null	Due on or before this date (ISO)
due_after	date | null	Due on or after this date (ISO)
overdue	boolean | null	Only tasks past their due date and not completed
sort_by	"task_id" | "title" | "status" | "priority" | "due_date" | "start_date" | "created_at" | "assignee" | "project_id" | "priority_rank" | "status_rank" | "task_type" | null
sort_order	"asc" | "desc" | null
project	string[] | null	Project ids, or __unfiled__

list_project_tasks List a project's tasks

What it does	Try
List the tasks of one project, optionally filtered by status, assignee, priority or due date.	“Which tasks in P31304 are blocked?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	tasks:read	GET /v1/tasks

Argument	Type	Description
limit	integer	Page size (default 25, at most 100)
cursor	string | null	The previous page's next_cursor, echoed back unchanged
status	("backlog" | "not_started" | "in_progress" | "blocked" | "completed" | "archived" | "on_hold")[] | null	Only these statuses
priority	("critical" | "high" | "medium" | "low" | "none")[] | null	Only these priorities
task_type	("task" | "bug")[] | null	Only these kinds: task, bug
due_before	date | null	Due on or before this date (ISO)
due_after	date | null	Due on or after this date (ISO)
overdue	boolean | null	Only tasks past their due date and not completed
sort_by	"task_id" | "title" | "status" | "priority" | "due_date" | "start_date" | "created_at" | "assignee" | "project_id" | "priority_rank" | "status_rank" | "task_type" | null
sort_order	"asc" | "desc" | null
project_id required	string
assignee	string[] | null	Usernames, or me

list_team_tasks List a team's unfiled tasks

What it does	Try
List a team's tasks that are not filed in any project (the team's List).	“What's in the Platform team's intake that nobody has picked up?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	teams:read	GET /v1/teams/{team_id}/intake

Argument	Type	Description
limit	integer	Page size (default 25, at most 100)
cursor	string | null	The previous page's next_cursor, echoed back unchanged
team_id required	string
sort_by	"task_id" | "title" | "status" | "priority" | "due_date" | "start_date" | "created_at" | "assignee" | "project_id" | "priority_rank" | "status_rank" | "task_type" | null
sort_order	"asc" | "desc" | null

get_task Get a task

What it does	Try
Read one task by its id, with its description, dates, assignee, links and type fields.	“Show me T123456.”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	tasks:read	GET /v1/tasks/{task_id}

Argument	Type	Description
task_id required	string

create_task Create a task

What it does	Try
Create a task in the organization, optionally in a project, with an assignee, priority and dates. Tasks you create may be held for review before they enter a private project.	“Create a high-priority task in P31304 to update the SOC 2 evidence, due Friday, assigned to me.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: false	tasks:write	POST /v1/tasks

Argument	Type	Description
title required	string
description	string | null
status	"backlog" | "not_started" | "in_progress" | "blocked" | "completed" | "archived" | "on_hold" | null
priority	"critical" | "high" | "medium" | "low" | "none" | null
assignee	string | null	The assignee's username
start_date	date | null
due_date	date | null
task_type	"task" | "bug" | null
project_id	string | null	The project to file it in; omit for an unfiled task
tags	string[] | null
team_id	string | null
sprint_id	string | null
milestone_id	string | null
goal_id	string | null

update_task Update a task

What it does	Try
Change a task's status, priority, assignee, dates, title, description or type; a field sent as null is cleared.	“Mark T123456 as in progress and move its due date to the 30th.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: trueopenWorldHint: false	tasks:write	PATCH /v1/tasks/{task_id}

Argument	Type	Description
title	string | null
description	string | null
status	"backlog" | "not_started" | "in_progress" | "blocked" | "completed" | "archived" | "on_hold" | null
priority	"critical" | "high" | "medium" | "low" | "none" | null
assignee	string | null	The assignee's username
start_date	date | null
due_date	date | null
task_type	"task" | "bug" | null
task_id required	string
tags	string[] | null

set_task_project Move a task to a project

What it does	Try
Move a task to another project of the organization, or take it out of its project.	“Move T123456 into the Website project.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: trueopenWorldHint: false	tasks:write	POST /v1/tasks/{task_id}/project

Argument	Type	Description
task_id required	string
project_id required	string | null	The target project, or null to take the task out of its project

set_task_sprint File a task in a sprint

What it does	Try
File a task in one of its team's sprints, or take it out of its sprint.	“Put T123456 in the current sprint.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: trueopenWorldHint: false	tasks:write	PUT /v1/tasks/{task_id}/sprint

Argument	Type	Description
task_id required	string
sprint_id required	string | null	A sprint of the task's team, or null for none

set_task_milestone Attach a task to a milestone

What it does	Try
Attach a task to one of its project's milestones, or detach it.	“Attach T123456 to the Beta launch milestone.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: trueopenWorldHint: false	tasks:write	PUT /v1/tasks/{task_id}/milestone

Argument	Type	Description
task_id required	string
milestone_id required	string | null	A milestone of the task's project, or null for none

set_task_section Place a task in a section

What it does	Try
Place a task in a section of a project, a team or your own list, or take it out of that scope's sections.	“Put T123456 under the 'This week' section of my list.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: trueopenWorldHint: false	tasks:write	PUT /v1/tasks/{task_id}/section

Argument	Type	Description
task_id required	string
scope_type required	"project" | "team" | "user"	Whose sections: a project's, a team's or your own
scope_id required	string	The project id, the team id, or your username for user
section_id	string | null	The section, or null to take the task out of that scope's sections
position	number | null	Omit to append at the end

add_subtask Add a subtask

What it does	Try
Link an existing task under another task as its subtask.	“Make T123457 a subtask of T123456.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: trueopenWorldHint: false	tasks:write	POST /v1/tasks/{task_id}/subtasks

Argument	Type	Description
task_id required	string
subtask_id required	string

remove_subtask Remove a subtask link

What it does	Try
Unlink a subtask from its parent task; both tasks stay.	“T123457 is no longer part of T123456 - unlink it.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: trueidempotentHint: trueopenWorldHint: false	tasks:write	DELETE /v1/tasks/{task_id}/subtasks/{subtask_id}

Argument	Type	Description
task_id required	string
subtask_id required	string

add_dependency Add a dependency

What it does	Try
Record that a task depends on another task.	“T123456 can't start until T123400 is done - record that.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: trueopenWorldHint: false	tasks:write	POST /v1/tasks/{task_id}/dependencies

Argument	Type	Description
task_id required	string
dependency_id required	string	The task this one depends on

remove_dependency Remove a dependency

What it does	Try
Remove a dependency between two tasks; both tasks stay.	“T123456 no longer depends on T123400.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: trueidempotentHint: trueopenWorldHint: false	tasks:write	DELETE /v1/tasks/{task_id}/dependencies/{dependency_id}

Argument	Type	Description
task_id required	string
dependency_id required	string	The task this one depends on

Comments 3 tools

list_comments List a task's comments

What it does	Try
List the comments on a task, each with its replies.	“What did people say on T123456?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	tasks:read	GET /v1/task-comments

Argument	Type	Description
limit	integer	Page size (default 25, at most 100)
cursor	string | null	The previous page's next_cursor, echoed back unchanged
task_id required	string
search	string | null	Only comments containing these words
sort_order	"asc" | "desc" | null

add_comment Comment on a task

What it does	Try
Post a comment on a task.	“Comment on T123456 that the fix is deployed to staging.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: false	tasks:write	POST /v1/task-comments

Argument	Type	Description
task_id required	string
content required	string	The comment text

reply_to_comment Reply to a comment

What it does	Try
Reply to a comment on a task.	“Reply to Ada's comment on T123456 that I'll take it.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: false	tasks:write	POST /v1/task-comments/reply

Argument	Type	Description
parent_comment_id required	string	The comment to reply to
content required	string

Projects 5 tools

list_projects List projects

What it does	Try
List the organization's projects you can read, optionally filtered by status, priority, team or words.	“Which active projects does the Platform team have?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	projects:read	GET /v1/projects/{org_id}

Argument	Type	Description
limit	integer	Page size (default 25, at most 100)
cursor	string | null	The previous page's next_cursor, echoed back unchanged
status	("planning" | "not_started" | "active" | "in_progress" | "on_hold" | "paused" | "blocked" | "completed" | "archived")[] | null	Only these statuses
priority	("critical" | "high" | "medium" | "low" | "none")[] | null	Only these priorities
team	string[] | null	Only projects filed under these team ids
search	string | null	Words to find in the name, description or id
show_all	boolean | null	true (default): every project you can read; false: only yours
sort_by	"name" | "status" | "priority" | "start_date" | "end_date" | "created_at" | "position" | null
sort_order	"asc" | "desc" | null

get_project Get a project

What it does	Try
Read one project by its id, with its owner, members, dates and progress.	“How far along is P31304?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	projects:read	GET /v1/projects/detail/{project_id}

Argument	Type	Description
project_id required	string

create_project Create a project

What it does	Try
Create a project in the organization; you become its owner.	“Create a private project called 'Q4 audit' starting next Monday.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: false	projects:write	POST /v1/projects

Argument	Type	Description
description	string | null
status	"planning" | "not_started" | "active" | "in_progress" | "on_hold" | "paused" | "blocked" | "completed" | "archived" | null
priority	"critical" | "high" | "medium" | "low" | "none" | null
start_date	date | null
end_date	date | null
visibility	"public" | "private" | null	public: every member of the organization can see it
team_id	string | null	The team the project is filed under
name required	string

update_project Update a project

What it does	Try
Change a project's name, description, status, priority, dates, visibility or team; a field sent as null is cleared.	“Put P31304 on hold.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: trueopenWorldHint: false	projects:write	PATCH /v1/projects/{project_id}

Argument	Type	Description
description	string | null
status	"planning" | "not_started" | "active" | "in_progress" | "on_hold" | "paused" | "blocked" | "completed" | "archived" | null
priority	"critical" | "high" | "medium" | "low" | "none" | null
start_date	date | null
end_date	date | null
visibility	"public" | "private" | null	public: every member of the organization can see it
team_id	string | null	The team the project is filed under
project_id required	string
name	string | null

list_project_members List a project's members

What it does	Try
List the people on a project and their project roles.	“Who is on P31304?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	projects:read	GET /v1/project-members

Argument	Type	Description
limit	integer	Page size (default 25, at most 100)
cursor	string | null	The previous page's next_cursor, echoed back unchanged
project_id required	string
search	string | null
role	string | null	Only members with this project role (owner, admin, member, viewer)

Teams 3 tools

list_teams List teams

What it does	Try
List the organization's teams with their member and project counts.	“Which teams do we have?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	teams:read	GET /v1/teams

Argument	Type	Description
limit	integer	Page size (default 25, at most 100)
cursor	string | null	The previous page's next_cursor, echoed back unchanged
search	string | null	Words to find in the team's name

get_team Get a team

What it does	Try
Read one team by its id, with its members.	“Tell me about the Platform team.”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	teams:read	GET /v1/teams/{team_id}

Argument	Type	Description
team_id required	string

list_team_members List a team's members

What it does	Try
List the people in a team and their team roles.	“Who is in the Platform team?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	teams:read	GET /v1/teams/{team_id}

Argument	Type	Description
team_id required	string

Sprints 3 tools

list_sprints List a team's sprints

What it does	Try
List a team's sprints with their dates, status and task counts.	“What sprints does the Platform team have, and which is current?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	teams:read	GET /v1/teams/{team_id}/sprints

Argument	Type	Description
limit	integer	Page size (default 25, at most 100)
cursor	string | null	The previous page's next_cursor, echoed back unchanged
team_id required	string

create_sprint Create a sprint

What it does	Try
Create a sprint for a team with a start date and an end date or a length in weeks.	“Start a two-week sprint 'Sprint 42' for the Platform team on Monday.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: false	teams:write	POST /v1/teams/{team_id}/sprints

Argument	Type	Description
description	string | null
goal	string | null	What the sprint is for, in the team's words
end_date	date | null	Last day (inclusive); give this or duration_weeks
duration_weeks	integer | null	The end date is derived as start + 7 × weeks − 1
team_id required	string
name required	string	Unique among the team's active sprints
start_date required	date

update_sprint Update a sprint

What it does	Try
Change a sprint's name, goal, dates or length, or complete it.	“Extend Sprint 42 by a week.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: trueopenWorldHint: false	teams:write	PUT /v1/teams/{team_id}/sprints/{sprint_id}

Argument	Type	Description
description	string | null
goal	string | null	What the sprint is for, in the team's words
end_date	date | null	Last day (inclusive); give this or duration_weeks
duration_weeks	integer | null	The end date is derived as start + 7 × weeks − 1
team_id required	string
sprint_id required	string
name	string | null
start_date	date | null
status	"active" | "completed" | null	completed closes the sprint; its tasks stay filed

Milestones 3 tools

list_milestones List milestones

What it does	Try
List one project's milestones, or every milestone you can read across the organization's projects, with their target dates and progress.	“Which milestones are due this month?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	projects:read	GET /v1/milestonesGET /v1/projects/{project_id}/milestones

Argument	Type	Description
limit	integer	Page size (default 25, at most 100)
cursor	string | null	The previous page's next_cursor, echoed back unchanged
project_id	string | null	One project's milestones; omit for every milestone you can read in the organization
status	"open" | "closed" | null	Only open, or only closed, milestones

create_milestone Create a milestone

What it does	Try
Create a milestone in a project with a target date and an optional owner.	“Add a 'Beta launch' milestone to P31304 on 15 November, owned by me.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: false	projects:write	POST /v1/projects/{project_id}/milestones

Argument	Type	Description
project_id required	string
title required	string	Unique among the project's milestones
target_date required	date	The date the project commits to
description	string | null
owner_user_id	string | null	The one accountable person: someone who can read the project (user id)

update_milestone Update a milestone

What it does	Try
Change a milestone's title, target date, description or owner, or close / reopen it.	“Close the Beta launch milestone.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: trueopenWorldHint: false	projects:write	PATCH /v1/projects/{project_id}/milestones/{milestone_id}

Argument	Type	Description
project_id required	string
milestone_id required	string
title	string | null
target_date	date | null
description	string | null
owner_user_id	string | null
status	"open" | "closed" | null

Goals 4 tools

list_goals List goals

What it does	Try
List one project's goals, or every goal you can read in the organization, with their task progress.	“What goals are we working towards, and how far along is each?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	projects:read	GET /v1/goalsGET /v1/projects/{project_id}/goals

Argument	Type	Description
limit	integer	Page size (default 25, at most 100)
cursor	string | null	The previous page's next_cursor, echoed back unchanged
project_id	string | null	One project's goals; omit for every goal you can read in the organization

create_goal Create a goal

What it does	Try
Create a goal in a project.	“Add a goal 'Pass the SOC 2 audit' to P31304, targeting 31 December.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: false	projects:write	POST /v1/projects/{project_id}/goals

Argument	Type	Description
project_id required	string
name required	string
target_date	date | null
description	string | null

update_goal Update a goal

What it does	Try
Change a goal's name, target date or description, or close / reopen it.	“Close the SOC 2 goal - we passed.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: trueopenWorldHint: false	projects:write	PATCH /v1/projects/{project_id}/goals/{goal_id}

Argument	Type	Description
project_id required	string
goal_id required	string
name	string | null
target_date	date | null
description	string | null
status	"open" | "closed" | null

file_tasks_under_goal File tasks under a goal

What it does	Try
File one or more tasks of a project under one of its goals.	“File T123456 and T123457 under the SOC 2 goal.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: trueopenWorldHint: false	projects:write	POST /v1/projects/{project_id}/goals/{goal_id}/tasks

Argument	Type	Description
project_id required	string
goal_id required	string
task_ids required	string[]	Tasks of the goal's project

Sections 3 tools

list_sections List sections

What it does	Try
List the sections of a project, a team or your own list, in order, with their task counts.	“What sections does P31304's list have?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	tasks:read	GET /v1/sections

Argument	Type	Description
limit	integer	Page size (default 25, at most 100)
cursor	string | null	The previous page's next_cursor, echoed back unchanged
scope_type required	"project" | "team" | "user"	Whose sections: a project's, a team's or your own list's
scope_id required	string	The project id, the team id, or your username for user

create_section Create a section

What it does	Try
Create a section in a project's, a team's or your own list.	“Add a 'Waiting on review' section to P31304.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: falseopenWorldHint: false	tasks:write	POST /v1/sections

Argument	Type	Description
scope_type required	"project" | "team" | "user"
scope_id required	string	The project id, the team id, or your username for user
name required	string
position	number | null	Omit to append at the end

update_section Rename or move a section

What it does	Try
Rename a section, or move it by changing its position.	“Rename the 'Waiting on review' section in P31304 to 'In review'.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: falseidempotentHint: trueopenWorldHint: false	tasks:write	PATCH /v1/sections/{section_id}

Argument	Type	Description
section_id required	string
name	string | null	Unique among the list's sections
position	number | null	The new sort key; sections order by it, lowest first

Saved views 3 tools

list_views List saved views

What it does	Try
List the saved views you can read: your own, your projects' and your teams'.	“What saved views do I have?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	tasks:read	GET /v1/views

Argument	Type	Description
limit	integer	Page size (default 25, at most 100)
cursor	string | null	The previous page's next_cursor, echoed back unchanged
resource	"task" | "project" | null	Views of the task list or of the projects list
scope	"user" | "team" | "project" | null	Whose views: yours (user), a team's or a project's

get_view Get a saved view

What it does	Try
Read a saved view's definition: its name, which list it queries and its filters, sort and grouping.	“What does my 'Overdue bugs' view filter on?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	tasks:read	GET /v1/views/{view_id}

Argument	Type	Description
view_id required	string

view_rows Show a saved view's rows

What it does	Try
List the rows a saved view shows right now: tasks or projects, per the view.	“Run my 'Overdue bugs' view.”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	tasks:read	GET /v1/views/{view_id}/rows

Argument	Type	Description
limit	integer	Page size (default 25, at most 100)
cursor	string | null	The previous page's next_cursor, echoed back unchanged
view_id required	string

Organization 3 tools

get_organization Get the organization

What it does	Try
Read the organization this connection acts in: its name, description, owners, your role and counts.	“Which organization am I working in, and who owns it?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	members:read	GET /v1/organizations/{org_id}

list_org_members List the organization's members

What it does	Try
List the organization's members with their role, designation, whether they are active and when they were last active.	“Who in the organization is a designer, and who has not been active this month?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	members:read	GET /v1/organization-members/{org_id}

Argument	Type	Description
limit	integer	Page size (default 25, at most 100)
cursor	string | null	The previous page's next_cursor, echoed back unchanged
search	string | null	Text to find in the member's username or email (case-insensitive)
role	string | null	Only members with this organization role (owner, admin, member, guest)
designation	string | null	Only members with this designation (its display name)
is_active	boolean | null	false lists the DEACTIVATED members instead (owner / admin only)

list_designations List designations

What it does	Try
List the designations (job titles) people in the organization can hold, flat or grouped by category.	“What designations can people in our organization have?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	members:read	GET /v1/designations

Argument	Type	Description
limit	integer	Page size (default 25, at most 100)
cursor	string | null	The previous page's next_cursor, echoed back unchanged
grouped	boolean	true → the catalog grouped by category ({groups: [{category, items}]}, one document, no paging); false → one flat list Default false.

Me 1 tool

whoami Who am I

What it does	Try
Show who this connection acts as: the person or service account, the organization and the granted scopes.	“Which Taskadence account and organization are you connected to?”

Annotations	Scopes	Calls
readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: false	none	GET /v1/me

Admin 6 tools

delete_task Delete a task

What it does	Try
Delete a task permanently.	“Delete T123456, it was a duplicate.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: trueidempotentHint: trueopenWorldHint: false	tasks:writeadmin	DELETE /v1/tasks/{task_id}

Argument	Type	Description
task_id required	string

delete_project Delete a project

What it does	Try
Delete (archive) a project.	“Delete the 'Old website' project.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: trueidempotentHint: trueopenWorldHint: false	projects:writeadmin	DELETE /v1/projects/{project_id}

Argument	Type	Description
project_id required	string

delete_comment Delete a comment

What it does	Try
Delete a comment on a task.	“Delete my last comment on T123456.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: trueidempotentHint: trueopenWorldHint: false	tasks:writeadmin	DELETE /v1/task-comments/{comment_id}

Argument	Type	Description
comment_id required	string

remove_project_member Remove a project member

What it does	Try
Remove a person from a project.	“Take Sam off P31304.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: trueidempotentHint: trueopenWorldHint: false	projects:writeadmin	DELETE /v1/project-members/{user_id}/{project_id}

Argument	Type	Description
project_id required	string
user_id required	string	The member's user id

remove_team_member Remove a team member

What it does	Try
Remove a person from a team.	“Remove Sam from the Platform team.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: trueidempotentHint: trueopenWorldHint: false	teams:writeadmin	DELETE /v1/teams/{team_id}/members/{user_id}

Argument	Type	Description
team_id required	string
user_id required	string	The member's user id

delete_section Delete a section - its tasks stay

What it does	Try
Delete a section; its tasks are not deleted, they become unsectioned in that list.	“Delete the empty 'Later' section from P31304.”

Annotations	Scopes	Calls
readOnlyHint: falsedestructiveHint: trueidempotentHint: trueopenWorldHint: false	tasks:writeadmin	DELETE /v1/sections/{section_id}

Argument	Type	Description
section_id required	string