Procrastinator MCP Server

# Procrastinator MCP A Model Context Protocol (MCP) server that provides task management capabilities for the Procrastinator application. ## Overview This MCP server acts as a bridge between Claude and the Procrastinator task management system, allowing users to interact with their tasks through natural language commands. It provides secure, OAuth-authenticated access to task operations. ## Features - **List Tasks**: View all your tasks with their details - **Create Tasks**: Add new tasks with title and optional description - **Update Tasks**: Modify existing tasks and mark them as completed - **OAuth Authentication**: Secure access using Bearer tokens - **Session Management**: Maintains persistent connections for efficient communication ## Available Tools ### `list_tasks` Retrieves all tasks for the authenticated user. ### `create_task` Creates a new task. - **Parameters:** - `title` (string, required): Task title - `description` (string, optional): Task description ### `update_task` Updates an existing task. - **Parameters:** - `id` (number, required): Task ID - `title` (string, required): Updated task title - `description` (string, required): Updated task description - `completed_at` (string, optional): Completion timestamp (YYYY-MM-DD HH:ii:ss format) ## Authentication The server uses OAuth 2.0 Bearer token authentication. All requests must include a valid Bearer token in the Authorization header. ### OAuth Metadata The server exposes OAuth metadata at `/.well-known/oauth-protected-resource` with the following scopes: - `claudeai` - `tasks:create` - `tasks:update` - `tasks:delete` - `tasks:view` ## Installation 1. Install dependencies: ```bash npm install ``` 2. Build the project: ```bash npm run build ``` 3. Start the server: ```bash node build/index.js ``` The server will start on port 3000. ## Configuration The server connects to the Procrastinator API at `https://procrastinator.test`. Make sure your environment has access to this endpoint.