MCP Tools Reference

Full reference for all 40+ MCP tools available in TR-1 for AI agent integration.

40+ tools available at /mcp. Connect with any MCP client.

Quick Start

# Claude Code (OAuth — automatic)
claude mcp add --transport http tr1 https://tr1.fieldbw.com/mcp

# With API key
claude mcp add --transport http tr1 https://tr1.fieldbw.com/mcp \
  -h "Authorization: Bearer YOUR_KEY"

Need an API key? Create one in the app under Account → API Keys. OAuth is recommended for MCP clients that support it — no key needed.

Inbox

capture

Quickly capture a thought, task, or idea into the GTD inbox.

ParamTypeRequired
titlestringYes
notesstringNo

get_inbox

Get all items in the GTD inbox.

process_inbox_item

Process a single inbox item by deciding where it goes.

ParamTypeRequired
idstringYes
statusnext | waiting | scheduled | someday | trashYes
projectIdstringNo
energylow | medium | highNo

clear_inbox

Process multiple inbox items at once.

Tasks

create_task

Create a new task. Set sortOrder to control position — lower values appear first.

ParamTypeRequired
titlestringYes
statusinbox | next | waiting | scheduled | somedayNo (default: next)
projectIdstringNo
todaybooleanNo
inProgressbooleanNo
sortOrdernumberNo
energylow | medium | highNo
prioritynumberNo
dueDatestring (YYYY-MM-DD)No
deferDatestring (YYYY-MM-DD)No
notesstringNo

update_task

Update any field on an existing task. Set inProgress: true and today: true when starting work. Use complete_task when done.

ParamTypeRequired
idstringYes
All create_task paramsOptional updates

complete_task

Mark a task as complete.

reopen_task

Reopen a completed task.

delete_task

Move a task to the trash.

get_task

Get full details of a single task by ID.

search_tasks

Search and filter tasks by query, status, type, project, area, energy.

batch_tasks

Perform multiple task operations in one call. Use this to reorder tasks efficiently.

move_task

Move a task to a different project, area, or status.

Views

get_today

Get today’s task list.

get_in_progress

Get tasks currently in progress.

get_next_actions

Get Next Actions. Filter by project to reduce payload.

ParamTypeRequired
projectIdstringNo
limitnumberNo

get_waiting_for

Get all Waiting For items.

get_someday_maybe

Get the Someday/Maybe list.

get_upcoming

Get upcoming scheduled tasks.

get_logbook

Get recently completed tasks.

get_by_context

Get tasks by GTD context.

Projects

create_project

Create a new project.

update_project

Update a project.

get_projects

Get all active projects.

get_project

Get a project with all its tasks.

review_projects

Review all active projects and identify stuck ones.

Organization

manage_areas

Create, list, update, or delete Areas.

manage_contexts

Create, list, update, or delete GTD Contexts.

manage_tags

Create, list, update, or delete tags.

manage_headings

Create, list, update, or delete project headings.

Reviews

start_weekly_review

Start a GTD weekly review.

daily_review

Run a quick daily review.

get_review_stats

Get system statistics, throughput, and project activity.

complete_review

Mark a review as complete.

Activity

get_activity

Get recent activity log.

get_agent_activity

Get recent agent activity.

undo_action

Undo a previous action.