MCP tools

Retrieves the authenticated user's daily standup report for today, including all associated tasks and their comments. Returns the standup formatted as markdown.

The backbone task query tool for agents deciding what to work on. Filters the authenticated user's accessible tasks by project, board column, tag, assignee, status, creation/due date windows, and priority, with configurable sorting. Use created_after to surface newly created work. Returns a compact, decision-ready list. Every query is scoped to projects the user owns or belongs to.

Returns a compact whole-board overview in a single call so an agent can reason about board state without many round-trips. Lists every column in order with its type, task count, and up to 5 open tasks, ending with open-vs-completed totals. Scoped to a project the authenticated user owns or belongs to.

Retrieves tasks that were completed today (or on a specific date) across all projects where the user is an owner or member. Shows who completed each task and when. Useful for daily standups, progress reports, and team updates.

Returns the task the authenticated user currently has a running timer on (task name, #number, started_at, elapsed time), or a clear message that no timer is running. Call this before StartStopTimetrackTool when you need to know current timer state rather than guess from a toggle.

Retrieves comprehensive details for a specific task, including description, assignees, todo lists, subtasks, dependencies, and recent comments. Tasks can be located by ID or by searching name and description.

Retrieves tasks currently in progress for a specific teammate. Searches for users by name across all shared projects. If multiple users match the name, returns a list with emails for clarification. Only shows tasks from columns marked as "in progress" or "progressing" type. Returns task names, priorities, board columns, and direct links.

Retrieves all boards and their columns for a specified project. Requires project membership. Provide the project name or a keyword to locate the project.

Lists all boards in a project, including each board's id, column count, and task count. Requires project membership. Use this to discover boards before creating tasks or a new board. Provide the project name or a keyword to locate the project.

Lists milestones in a project with progress information. Shows each milestone's name, dates, task counts, and completion percentage. Use this to find existing milestones before creating new ones or assigning tasks. If no project is specified, lists milestones across all accessible projects.

Retrieves tasks assigned to the authenticated user. Returns task names, due dates, priorities, board columns, completion status, and direct links to each task.

Retrieves all projects that the authenticated user is a member of. Returns project names, user roles (owner, admin, member, or guest), member counts, and the project owner's plan type.

Verifies connectivity to the Taskavel MCP server. Returns a pong response confirming the connection along with the authenticated user's email address.

Reports what changed recently across the authenticated user's accessible projects — the tool an agent polls to triage newly created bugs. Returns three compact sections within a time window: newly CREATED tasks, recently UPDATED tasks (created before the window), and recent COMMENTS on tasks. Scoped to projects the user owns or belongs to.

Searches for tasks by keyword across all projects the authenticated user belongs to. Matches against task names and descriptions. Returns up to 20 results with project context and priority information.

Retrieves tasks with upcoming deadlines within the specified number of days (default 7), including overdue tasks. Results are scoped to projects the authenticated user belongs to.

Adds a comment to a task. Requires owner, admin, or member role in the project. Guests cannot comment.

Assigns or removes tasks to/from a milestone. Actions: "assign" (set milestone on tasks), "remove" (clear milestone from tasks). Can operate on a single task or multiple tasks at once. If the milestone does not exist, suggests creating one. Requires owner, admin, or member role.

Assigns, replaces, or removes task assignees. Actions: "assign" adds a user without removing existing assignees, "replace" makes the selected user the only assignee, and "remove" unassigns the selected user. The target user must be part of the task project, and the acting user must have owner, admin, or member role.

Moves multiple tasks at once to a target column. Filter tasks by teammate name, milestone, or current column. As admin/owner you can move any team member's tasks. If the target column is not found, lists available columns for the user to pick. Requires owner or admin role.

Creates a new board in a project, optionally seeded from a template. Requires owner, admin, or member role. Guests cannot create boards. Provide the project name and board name at minimum.

Creates a new milestone in a project. Milestones group related tasks and track progress toward a goal. Provide the project and milestone name at minimum. Requires owner, admin, or member role.

Creates a whole project in one call. Pass just a name for a project with a default board, or pass a full structure (columns, milestones, tasks) that you have designed yourself. The calling agent is the generator here; this tool only persists the structure and does NOT run the paid asynchronous AI generation pipeline. The creator becomes the project owner.

Creates a new tag in a project. Tags have a name, optional color, and optional description. Requires owner, admin, or member role.

Creates a new task in a project. Requires owner, admin, or member role. Provide the project name and task name at minimum.

Duplicates a task, including its checklists (todos), tags, and assignees. The new task is named "(duplicated) <original name>" and owned by the calling user. Requires owner, admin, or member role.

Invites a user to a project by email. Only project owners and admins can invite members. Free plan limits apply (maximum 5 members). Sends an invitation email to the specified address.

Manages the authenticated user's daily standup report. Add tasks to today's standup, set comments per task, or set a summary. Creates today's standup if it does not exist.

Manages subtasks of a parent task. A subtask is a task linked to its parent. Use action=create to add a subtask (optionally with a due date) or action=list to read the parent's subtasks. Requires owner, admin, or member role.

Manages checklists (todo lists) on a task and their items. A checklist groups lightweight checkable items. Use action=create_checklist to add a checklist, add_item to append an item, toggle_item to flip an item complete/incomplete, and list to read all checklists with progress. Requires owner, admin, or member role.

Manages dependencies between two tasks. Action "add" (default) links task_id and related_task_id reciprocally: a "blocked_by" link on task_id creates a matching "blocks" link on related_task_id, and vice versa. Action "remove" detaches the link in both directions. Requires owner, admin, or member role.

Manages reminders on a task. Use action=add to schedule a reminder, list to read a task's reminders, or remove to delete one by id. Requires owner, admin, or member role.

Manages tags on a task. Actions: "add" (attach tags without removing existing), "remove" (detach specific tags), "set" (replace all tags). Provide tag_names or tag_ids. Requires owner, admin, or member role.

Moves a task to a different column on the board. Useful for changing task status like moving from "To Do" to "In Progress" or "Done". Requires owner, admin, or member role.

IMPORTANT: Use THIS tool when the user wants to reply to a comment. The comment_id is the number shown as #xxx in the Taskavel UI. Example: user says "reply to comment #1276" → use this tool with comment_id=1276. Supports mentioning users by name or email.

Sets or clears the priority of a task. Use priority_name (e.g., "High Priority", "Medium Priority", "Low Priority") or priority_id to set, or clear=true to remove priority. Requires owner, admin, or member role.

Starts or stops time tracking on a task. Pass `action: "stop"` to explicitly stop — it is a safe no-op (never starts a timer) if this task has no running timer. Pass `action: "start"` to explicitly start — it is a safe no-op if this task's timer is already running. Starting a timer always stops any other task's running timer for this user first (only one timer runs at a time); the response names that other task whenever this happens. Omit `action` for legacy toggle behavior: stops the timer if this task's timer is running, otherwise starts one (stopping any other running timer first). Use GetRunningTimerTool first if you need to know current timer state before deciding. Requires owner, admin, or member role.

Toggles whether the calling user is watching (subscribed to notifications for) a task. Any project member can watch a task.

Updates an existing milestone. Can change name, description, dates, and color. Resolve by milestone_id or search by name within a project. Requires owner, admin, or member role.

Updates an existing task. Supports renaming, changing the description, modifying due dates, and marking tasks as complete or incomplete. Task completion is validated against incomplete subtasks, todo items, and blocking dependencies. Requires owner, admin, or member role.

Uploads a file attachment (screenshot, log, PDF, ...) to a task. Send the raw file bytes base64-encoded in file_base64 together with a file_name that includes the extension, e.g. "screenshot.png". A data URI prefix ("data:image/png;base64,...") is accepted and stripped. Max 10 MB per file after decoding; the file also counts against the project owner's storage quota. Allowed extensions: images (jpg, jpeg, png, gif, webp, heic), video (mp4, mov, webm, ...), audio (mp3, wav, ogg), documents (pdf, txt, md, rtf, doc, docx, xls, xlsx, ppt, pptx) and archives (zip, rar, tar, gz). Use it to attach evidence to a task — screenshots of a bug, a failing log, a generated report. Requires owner, admin, or member role in the project; guests cannot upload.

Archives (soft-deletes) a task. The task is hidden from boards but can be restored later; it is not permanently deleted. Requires owner, admin, or member role.

Deletes a milestone from a project. Tasks assigned to this milestone will be unlinked but NOT deleted. Requires owner or admin role. Ask the user for confirmation before deleting.

Permanently deletes a tag from a project and detaches it from all tasks. Requires owner, admin, or member role. Use tag_id or tag_name to identify the tag.

Permanently deletes a task that is ALREADY ARCHIVED. This is irreversible. It mirrors the app's trash → empty-trash flow: a task must first be archived (ArchiveTaskTool), then it can be purged from the archive here. Active tasks cannot be permanently deleted in one step. Requires confirm:true and owner, admin, or member role.

Removes a member from a project. Only project owners and admins can remove members. The project owner cannot be removed.