procrastinator-mcp-server

mateusjunges/procrastinator-mcp-server

3.2

If you are the rightful owner of procrastinator-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.

The Procrastinator MCP server facilitates task management through natural language commands, integrating with the Procrastinator application.

Tools

  1. list_tasks

    Retrieves all tasks for the authenticated user.

  2. create_task

    Creates a new task with a title and optional description.

  3. update_task

    Updates an existing task with new details and completion status.

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:

    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.