tududi-mcp

A whitelabel Model Context Protocol (MCP) server that connects LLM-powered clients to Tududi — an open-source productivity and GTD (Getting Things Done) application created by Chris Vel.

Tududi helps users organise tasks, projects, notes, and areas following GTD methodology. This MCP server acts as a bridge, allowing AI assistants (Claude, Cursor, VS Code Copilot, etc.) to read and manipulate Tududi data through a standardised protocol.

> Prerequisite: You need a running Tududi instance (self-hosted) with API access enabled. The MCP server connects to Tududi's REST API and does not include the Tududi application itself.

The server exposes a single MCP endpoint at `app/mcp/route.ts` built on Next.js Route Handlers. On each request, it:

1. Authenticates — validates the bearer token against the Tududi instance's /api/profile endpoint.
2. Registers modules — lazily loads all 8 domain modules (tasks, projects, notes, areas, inbox, tags, profile, metrics) and registers their tools and resources with the MCP server.
3. Serves tools & resources — the connected MCP client discovers and invokes them as needed.

Authentication is handled via `mcp-handler`'s withMcpAuth wrapper with token verification against the Tududi API.

• Tools (7): list_tasks, get_task, create_task, update_task, delete_task, toggle_task_completion, list_subtasks
• Resources (2): tududi://tasks, tududi://tasks/{uid}

• Tools (4): list_projects, create_project, update_project, delete_project
• Resources (2): tududi://projects, tududi://projects/{uid}

• Tools (4): list_notes, create_note, update_note, delete_note
• Resources (1): tududi://notes

• **Tools (