gtd-mcp-server

alosec/gtd-mcp-server

3.3

If you are the rightful owner of gtd-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A minimal Node.js MCP server for GTD-style project and task management.

Tools
17
Resources
0
Prompts
0

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.