mateusjunges/procrastinator-mcp-server

The MCP server built for the blog post on how to let ai interact with your laravel app.

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.