TASKFLOW TOOLS

50 tools from the Taskflow MCP Server, categorised by risk level.

View the Taskflow policy →

READ TOOLS

29
ask_agent Ask another agent a question and wait for their response. Like ask_user but targets an agent. Returns the message ID — use check_response to poll f... ask_user Post a question to the TaskFlow Agent Inbox for the user to answer remotely. Returns immediately with the message ID. The question appears in the A... bootstrap **CALL THIS FIRST.** One-shot startup: returns your agent instructions, active project (auto-detected from folder name), open/blocked tasks, unread... capture_terminal Capture the current terminal content of an agent's tmux pane. Returns the visible text on screen. Useful for seeing what prompts or output an agent... check_broadcast Check the status of a broadcast message — shows which agents have responded and their answers. check_messages Check for incoming messages from users or other agents addressed to this agent. check_response Check if a previously posted question (via ask_user or ask_agent) has been answered. Returns the response if answered, or status "pending" if still... compact_activity_log Compact old activity log entries into a summary. Keeps the most recent entries (default 50) and summarizes the rest. Use dry_run=true to preview wh... get_activity_log Retrieve recent activity log entries. Shows what has changed — task completions, timer events, status transitions. Filter by action or entity type. get_agent_instructions **Call this at the start of every conversation.** Returns onboarding instructions, behavioral rules, and live project context for AI agents working... 2/5 get_analytics Get a high-level analytics summary: total focused time, task completion rates, status distribution, and time per project. Useful for standup report... get_checkpoint Get the latest checkpoint for a task. Returns the full task snapshot — useful for resuming work after an interruption. get_project Get a project by ID with all its tasks. Use this to understand the full scope of a project before starting work. get_setting Get a setting value by key. Server settings (port, host, databasePath, logLevel, agentLivenessInterval, maxPortAttempts) come from ~/.taskflow_conf... get_task Get a task by ID with time tracking info. Read the description carefully — it often contains implementation details and acceptance criteria. get_task_cost Get per-task cost metrics: tool calls made during active timer sessions, total execution time, and tool breakdown. Useful for understanding which t... get_timeline Get focused time grouped by day or week. Use for visualizing work patterns over time. get_tool_stats Get tool execution statistics: call count, success rate, average duration per tool. Shows which tools are used most and which are slow or failing. list_agents List registered agents with their status, project path, and connection info. list_checkpoints List all available checkpoints for a task. list_notifications List notifications. Check with unread_only=true at conversation start to surface important updates for the user. list_projects List all projects with task count. Call this at conversation start to understand the workspace. list_sessions List timer sessions with optional filters. Use to review time spent on a task or across a date range. list_tasks List tasks with optional filters. Use at conversation start to see what is in progress or blocked. Filter by status, project, priority, or tag. log_debug Log a debug entry to the activity log. Use this to record your work process — what you investigated, commands you ran, decisions you made, and find... pause_timer Pause the active timer session for a task. Call when switching context or waiting for user input. The task transitions to "paused". respond_to_message Respond to a pending message addressed to this agent. Use check_messages to see incoming messages, then respond by message ID. search_projects Search projects by name or description. Use this to find projects related to your current work. 2/5 search_tasks Search tasks by title or description. Use this to find tasks related to your current work before creating duplicates. 2/5

WRITE TOOLS

14
broadcast_agents Send a question to multiple agents simultaneously. Creates a group message — each agent gets their own copy linked by a shared broadcast ID. Use ch... 2/5 bulk_create_tasks Create multiple tasks in a single transaction. Useful when breaking down a feature into subtasks. 2/5 create_checkpoint Create a checkpoint snapshot of a task's current state. Captures: task data, dependencies, recent activity, active timer, tool stats. Useful before... 2/5 create_project Create a new project. Projects group related tasks and track time across them. 2/5 create_task Create a new task. Use this when starting new work to keep TaskFlow in sync. Supports dependencies, tags, links, and time estimates. 3/5 mark_all_notifications_read Mark all unread notifications as read. Call after the user has been briefed on pending notifications. 2/5 mark_notification_read Mark a notification as read after surfacing it to the user. 2/5 register_agent Register this agent with a custom name. Optional — agents auto-register on startup using the project folder name. Call this only if you want a spec... 2/5 send_keys Send raw keystrokes to an agent's tmux pane. Use this to respond to interactive prompts (yes/no, numbered choices, permission approvals) displayed ... 2/5 send_to_agent Send a message to another agent by name. Returns immediately. The recipient agent will receive the message in their terminal (if running in tmux). 2/5 update_project Update project fields such as name, color, type, or description. 2/5 update_setting Update a setting value. Server settings (port, host, databasePath, logLevel, agentLivenessInterval, maxPortAttempts) are written to ~/.taskflow_con... 2/5 update_task Update task fields. Use this to add details, update descriptions with progress notes, or adjust priority as you learn more. 3/5 update_task_status Update task status with transition validation. Use when a task becomes blocked, is partially done, or needs to be reopened. 2/5

DESTRUCTIVE TOOLS

5

EXECUTE TOOLS

2
How many tools does the Taskflow MCP server have? +

The Taskflow MCP server exposes 50 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Taskflow tools? +

Use Intercept, the open-source MCP proxy. Write YAML rules for each tool — rate limits, argument validation, or deny rules — then run Intercept in front of the Taskflow server.

What risk categories do Taskflow tools fall into? +

Taskflow tools are categorised as Read (29), Write (14), Destructive (5), Execute (2). Each category has a recommended default policy.

Enforce policies on Taskflow

Open source. One binary. Zero dependencies.

npx -y @policylayer/intercept
github.com/policylayer/intercept →
// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.