TaskPriority MCP Server

An intelligent task prioritization server that integrates with Claude Desktop through the Model Context Protocol (MCP). TaskPriority helps you manage tasks efficiently by providing AI-powered analysis including priority scoring, time estimation, and similarity detection.

🌟 Features

• AI-Powered Task Analysis: Automatic priority scoring (1-10), complexity assessment, and time estimation
• Smart Task Management: Create, update, list, and delete tasks with full CRUD operations
• Similarity Detection: Identifies duplicate and related tasks to prevent redundancy
• Real-time Analysis: Get instant AI insights when creating or analyzing tasks
• MCP Integration: Seamlessly works with Claude Desktop for natural language task management

📋 Prerequisites

• Python 3.10 or higher
• Claude Desktop (for MCP integration)
• TaskPriority API key from taskpriority.ai

🚀 Quick Start

1. Install the Server

Choose one of these installation methods:

Option A: Install from PyPI (Recommended)

pip install taskpriority-mcp

Option B: Install from GitHub

pip install git+https://github.com/greenblat17/priority-mcp.git

Option C: Install from Source

git clone https://github.com/greenblat17/priority-mcp.git
cd mcp-priority
pip install -e .

2. Get Your API Key

1. Sign up at taskpriority.ai
2. Go to Settings → API Keys
3. Create a new key (starts with tp_live_)

3. Configure Claude Desktop

Find your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Add this configuration

{
  "mcpServers": {
    "taskpriority": {
      "command": "taskpriority-mcp",
      "env": {
        "TASKPRIORITY_API_KEY": "tp_live_your_api_key_here"
      }
    }
  }
}

4. Restart Claude Desktop

Completely quit and restart Claude Desktop for the changes to take effect.

💡 Usage

Once configured, you can use natural language commands in Claude Desktop:

Creating Tasks

"Create a task to implement user authentication"
"Add a bug report about the login page not loading"
"New task: Improve database query performance"

Listing Tasks

"Show me all my pending tasks"
"List high-priority bugs"
"What tasks are in progress?"

Updating Tasks

"Mark task 123e4567 as completed"
"Update the authentication task to in-progress"
"Change the priority of the database task"

Getting AI Analysis

"Analyze task 123e4567"
"What's the time estimate for the authentication task?"
"Show me tasks similar to implementing payment processing"

🛠️ Available MCP Tools

create_task

Creates a new task with automatic AI analysis.

Parameters:

• description (required): Task description
• source (optional): Origin of the task (default: "internal")
• customer_info (optional): Additional context

list_tasks

Lists tasks with filtering options.

Parameters:

• status (optional): Filter by status (pending, in_progress, completed, blocked)
• category (optional): Filter by category (bug, feature, improvement, business, other)
• limit (optional): Number of results (default: 50, max: 100)
• offset (optional): Pagination offset (default: 0)

get_task_details

Retrieves complete information about a specific task.

Parameters:

• task_id (required): UUID of the task

update_task

Updates an existing task.

Parameters:

• task_id (required): UUID of the task
• status (optional): New status
• description (optional): Updated description
• customer_info (optional): Updated customer information

delete_task

Deletes a task permanently.

Parameters:

• task_id (required): UUID of the task

get_ai_analysis

Gets or waits for AI analysis of a task.

Parameters:

• task_id (required): UUID of the task
• timeout (optional): Max seconds to wait for analysis (default: 30)

🔧 Configuration

Environment Variables

Variable	Description	Default	Required
TASKPRIORITY_API_KEY	Your TaskPriority API key	-	Yes
TASKPRIORITY_API_URL	TaskPriority API base URL	https://api.taskpriority.ai	No
TASKPRIORITY_API_VERSION	API version	v1	No
TASKPRIORITY_TIMEOUT	Request timeout in seconds	30	No
DEBUG_MODE	Enable debug logging	false	No

Advanced Configuration

For advanced configuration options, see the Configuration Guide.

📚 Documentation

• API Reference - Detailed API documentation
• Development Guide - Contributing and development setup
• Deployment Guide - Production deployment instructions
• Examples - Code examples and use cases

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details on our code of conduct and the process for submitting pull requests.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with the Model Context Protocol
• Powered by TaskPriority AI
• Integrated with Claude Desktop

📞 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: support@taskpriority.ai

---

Made with ❤️ by the TaskPriority team