---
title: "MCP Tools Reference"
source: https://fieldbw.com/docs/tr-1/mcp-tools
---

# MCP Tools Reference

[Task Register TR-1](https://tr1.fieldbw.com) provides 40+ tools available at `/mcp`. Connect with any MCP client.

## Quick Start

```bash
# 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.

| Param | Type | Required |
|-------|------|----------|
| `title` | string | Yes |
| `notes` | string | No |

### get_inbox

Get all items in the GTD inbox.

### process_inbox_item

Process a single inbox item by deciding where it goes.

| Param | Type | Required |
|-------|------|----------|
| `id` | string | Yes |
| `status` | next \| waiting \| scheduled \| someday \| trash | Yes |
| `projectId` | string | No |
| `energy` | low \| medium \| high | No |

### clear_inbox

Process multiple inbox items at once.

## Tasks

### create_task

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

| Param | Type | Required |
|-------|------|----------|
| `title` | string | Yes |
| `status` | inbox \| next \| waiting \| scheduled \| someday | No (default: next) |
| `projectId` | string | No |
| `today` | boolean | No |
| `inProgress` | boolean | No |
| `sortOrder` | number | No |
| `energy` | low \| medium \| high | No |
| `priority` | number | No |
| `dueDate` | string (YYYY-MM-DD) | No |
| `deferDate` | string (YYYY-MM-DD) | No |
| `notes` | string | No |

### update_task

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

| Param | Type | Required |
|-------|------|----------|
| `id` | string | Yes |
| All `create_task` params | — | Optional 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.

| Param | Type | Required |
|-------|------|----------|
| `projectId` | string | No |
| `limit` | number | No |

### 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.