AI-native Getting Things Done system with SOP-driven meeting management
GTD Manager is a Model Context Protocol (MCP) server that implements Getting Things Done methodology specifically designed for team leads and engineering managers dealing with extreme context switching. Unlike traditional GTD applications, it integrates seamlessly with AI assistants and allows complete workflow customization through markdown-based Standard Operating Procedures (SOPs).
Perfect for: Team leads managing 15-20 meetings per week who need a trusted system that adapts to their unique organizational processes.
- Universal Capture: Add items from any MCP-enabled AI assistant
- Smart Clarification: Process inbox items into actionable projects and tasks
- Context Organization: GTD contexts optimized for knowledge work
- Comprehensive Reviews: Daily and weekly review workflows
- Custom SOPs: Create markdown templates for different meeting types
- Action Extraction: Automatically identify and track action items from notes
- Stakeholder Tracking: Maintain relationships and context over time
- Pre-meeting Preparation: Automated checklists based on meeting type
- Quip Integration: Full CRUD operations via Quip API
- Local Markdown: File-based storage with frontmatter metadata
- Hybrid Approach: Mix and match storage backends per workflow
- MCP Protocol: Native integration with Claude Desktop, Cursor, and other MCP clients
- Natural Language: Capture and process items using conversational commands
- Zero Context Switching: Manage tasks without leaving your development environment
- Python 3.13+
- PostgreSQL 17+ (with JSONB support)
- MCP-compatible client (Claude Desktop, Cursor, etc.)
# Install via uvx (no local setup required)
uvx --from git+https://github.com/peerjakobsen/gtd-manager-mcp gtd-manager# Clone the repository
git clone https://github.com/peerjakobsen/gtd-manager-mcp.git
cd gtd-manager-mcp
# Install with uv
uv sync
# Set up database
docker compose up -d postgres
# Initialize database
uv run alembic upgrade head
# Start the MCP server
uv run gtd-managerCreate a .env file in your project root:
# Database
DATABASE_URL=postgresql://user:password@localhost/gtd_manager
# Storage Backend (choose one or both)
QUIP_API_TOKEN=your_quip_api_token_here
LOCAL_STORAGE_PATH=~/.gtd-manager/data
# MCP Settings
MCP_TRANSPORT=stdio
LOG_LEVEL=INFOAdd to your Claude Desktop configuration:
{
"mcpServers": {
"gtd-manager": {
"command": "uvx",
"args": ["--from", "git+https://github.com/peerjakobsen/gtd-manager-mcp", "gtd-manager"],
"env": {
"DATABASE_URL": "postgresql://localhost/gtd_manager",
"QUIP_API_TOKEN": "your_token_here"
}
}
}
}-
Capture Everything
@gtd capture "Follow up with Sarah about project timeline" @gtd quick-capture "Buy birthday gift for Mom" -
Process Your Inbox
@gtd inbox-review @gtd clarify-item "Follow up with Sarah about project timeline" -
Organize by Context
@gtd next-actions @computer @gtd next-actions @meeting -
Review and Plan
@gtd daily-review @gtd weekly-review
Create a markdown file in your SOPs directory:
---
type: meeting
name: "Team Standup"
duration: 15
contexts: ["@team_meeting"]
stakeholders:
required: ["team_lead", "developers"]
optional: ["product_manager"]
---
# Daily Team Standup SOP
## Pre-Meeting Checklist
- [ ] Review yesterday's commitments
- [ ] Check for blockers in task board
- [ ] Prepare status updates
## Meeting Agenda
### 1. What did you accomplish yesterday? (5 min)
### 2. What will you work on today? (5 min)
### 3. Any blockers or help needed? (5 min)
## Post-Meeting Actions
- [ ] Update task board with new commitments
- [ ] Schedule follow-up sessions for blockers
- [ ] Send summary to absent team memberscapture_item- Add item to GTD inboxclarify_item- Process inbox item into action/projectcreate_meeting- Schedule meeting with SOPinbox_review- View and process inbox itemsnext_actions- List actions by contextweekly_review- Comprehensive GTD reviewdaily_review- Quick morning planningcreate_project- Multi-step outcome planning
gtd-manager-mcp/
├── src/gtd_manager/
│ ├── server.py # FastMCP server setup
│ ├── domain/ # GTD domain models
│ ├── services/ # Business logic
│ ├── repositories/ # Data access
│ └── sops/ # SOP processing
├── tests/ # Test suite
├── migrations/ # Database migrations
├── examples/ # Example SOPs
└── docs/ # Documentation
# Run all tests
uv run pytest
# Run with coverage
uv run pytest --cov=src/gtd_manager
# Run specific test
uv run pytest tests/test_capture.py# Generate migration
uv run alembic revision --autogenerate -m "Description"
# Apply migrations
uv run alembic upgrade head
# Rollback
uv run alembic downgrade -1When configured with a Quip API token, the system can:
- Create and update documents for projects and meeting notes
- Sync action items between GTD system and Quip documents
- Maintain folder structure aligned with GTD contexts
Files are stored in a structured directory:
~/.gtd-manager/
├── inbox/
├── projects/
├── contexts/
│ ├── computer/
│ ├── meeting/
│ └── phone/
├── meetings/
└── sops/
This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0).
You are free to:
- Use this software for personal, educational, and non-commercial purposes
- Study and learn from the source code
- Modify and create derivative works for non-commercial use
You may not:
- Use this software for commercial purposes without explicit permission
- Sell or monetize this software or derivative works
For commercial licensing inquiries, please contact: support@gtdmanager.dev
See the LICENSE file for full details or visit: https://creativecommons.org/licenses/by-nc/4.0/
For questions or issues, contact: peer.jakobsen@gmail.com
Built with FastMCP and the Model Context Protocol