GTD MCP Server

A minimal Node.js MCP (Model Context Protocol) server for GTD-style project and task management.

Features

• Inbox-first workflow: Capture everything quickly, process later
• Project organization: Multi-step outcomes with associated actions
• Context-based actions: Organize tasks by where they can be done (@calls, @computer, @errands)
• GTD workflows: Process inbox, weekly reviews, waiting for tracking
• Simple storage: JSON files for easy backup and portability

Installation

cd gtd-mcp-server
npm install

Claude Code Integration

Install the server for Claude Code:

# From the gtd-mcp-server directory
claude mcp add-json gtd-server '{"command": "node", "args": ["index.js"], "cwd": "'$(pwd)'"}'

Verify installation:

claude mcp list

The server should show as "✓ Connected".

Usage

The server runs as an MCP server and provides the following tools:

Primary Capture

• inbox - Capture anything quickly (primary entrypoint)
• list_inbox - Show unprocessed inbox items

Processing

• process_inbox - Convert inbox items to projects/actions or discard

Project Management

• create_project - Create new projects
• list_projects - List projects by status
• complete_project - Mark projects as done
• move_to_someday - Move to someday/maybe
• activate_project - Activate someday projects

Action Management

• add_action - Create next actions
• complete_task - Mark actions as done
• set_waiting - Set action as waiting for others
• set_next - Convert waiting to next action
• list_next_actions - Show all next actions
• list_waiting - Show waiting for items

Context Views

• list_by_context - Group actions by context
• list_contexts - Show available contexts

Review

• weekly_review - Comprehensive GTD review

GTD Workflow

1. Capture: Use inbox to quickly capture thoughts, tasks, ideas
2. Process: Use process_inbox to organize items into projects and actions
3. Organize: Use context-based tools to see actionable items
4. Review: Use weekly_review to maintain system health
5. Do: Work from context lists (list_by_context)

Data Storage

Data is stored in simple JSON files in the data/ directory:

• inbox.json - Unprocessed captured items
• projects.json - Projects and their metadata
• actions.json - Next actions and waiting items

Starting the Server

npm start

The server uses stdio transport for MCP communication.