TaskWorkr MCP Server

A Model Context Protocol (MCP) server for TaskWorkr - providing task management and project organization capabilities to AI assistants.

Features

• Task Management: Create, read, update, and manage tasks
• Project Organization: Organize tasks by projects
• Status Tracking: Track task progress with different statuses
• Priority Management: Set and manage task priorities
• Category Classification: Organize tasks by categories
• Time Estimation: Track estimated hours for tasks

Installation

npm install -g @taskworkr/mcp

Usage

With Cursor/Claude Desktop

Add to your MCP configuration file (.cursor/mcp.json or similar):

{
  "mcpServers": {
    "taskworkr": {
      "command": "@taskworkr/mcp",
      "env": {
        "DATABASE_URL": "your-postgresql-database-url"
      }
    }
  }
}

Environment Variables

• DATABASE_URL: PostgreSQL connection string (required)

Available Tools

test_connection

Test the MCP server connection.

get_tasks

Retrieve tasks with optional filtering:

• projectId: Filter by project ID
• status: Filter by status (not_started, in_progress, completed, blocked)
• limit: Maximum number of tasks to return (default: 20)

create_task

Create a new task:

• title: Task title (required)
• description: Task description (required)
• projectId: Project ID (required)
• priority: Task priority (low, medium, high, critical)
• category: Task category (frontend, backend, database, etc.)
• estimatedHours: Estimated hours to complete
• tags: Array of tags

update_task_status

Update task status:

• taskId: Task ID (required)
• status: New status (required)
• notes: Optional notes about the status change

get_projects

Retrieve all projects with optional task counts.

Development

# Clone the repository
git clone https://github.com/your-username/taskworkr-mcp.git
cd taskworkr-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.