What is TR-1?
TR-1 is a GTD-inspired task management system with a built-in MCP server. It lets humans and AI agents work from the same task list — creating, organizing, completing, and reviewing tasks through a shared system.
The web app is at tr1.fieldbw.com. Sign up for an account to get started.
Using the App
TR-1 is keyboard-first. Press Ctrl+N to capture tasks, use arrow keys to navigate, and single-key shortcuts to act on tasks (e.g., X to complete, N to move to Next Actions, M to open the Move panel).
For the full interface guide, keyboard shortcuts, and feature overview, see Using TR-1.
Connecting AI Agents
MCP (recommended)
Connect any MCP-compatible client (Claude Code, Claude Desktop, Cursor, ChatGPT) with a single URL. Agents get 40+ tools to manage tasks, projects, and reviews.
claude mcp add --transport http tr1 https://tr1.fieldbw.com/mcpMost MCP clients handle OAuth automatically — just add the URL and sign in when prompted.
For API key auth:
claude mcp add --transport http tr1 https://tr1.fieldbw.com/mcp \
-h "Authorization: Bearer YOUR_KEY"See the MCP Tools Reference for the full list of 40+ tools.
REST API
Standard JSON API for scripts, integrations, and custom tooling.
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://tr1.fieldbw.com/api/v1/inboxSee the REST API Reference for all endpoints.
Authentication
OAuth (recommended for MCP): Most MCP clients handle this automatically. Just add the URL and sign in when prompted.
API keys: Generate in the app under Account → API Keys. Pass as a Bearer token. Good for scripts and clients that don’t support OAuth.
Session cookies: The web UI uses session-based auth. Not recommended for integrations.
Core Concepts
| Concept | Description |
|---|---|
| Task | A single action item with status, project, dates, energy, priority |
| Project | An outcome requiring multiple tasks. Has its own status and tasks. |
| Area | An ongoing area of responsibility. Contains projects. |
| Status | inbox, next, waiting, scheduled, someday, completed |
| Today flag | Marks a task for today’s focus. Independent of status. |
| In Progress | Marks a task as actively being worked on. |
Next Steps
- GTD Primer — understand the methodology behind TR-1
- Using TR-1 — interface guide, keyboard shortcuts, and features
- Use Cases and Examples — practical patterns for working with AI agents and automation
- MCP Tools Reference — full reference for all 40+ MCP tools
- REST API Reference — endpoint documentation for scripts and integrations