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.

Related MCP server: MCP Claude Code

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:

   npm install

2. Build the project:

   npm run build

3. Start the server:

   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.