taskpriority-mcp 1.2.0
MCP server for intelligent task prioritization with Claude Desktop
License: MIT
Requires Python: >=3.10
Keywords: mcp, claude, taskpriority, ai, task-management

# TaskPriority MCP Server

[![MCP Version](https://img.shields.io/badge/MCP-1.12.3-blue)](https://github.com/modelcontextprotocol/servers)
[![Python Version](https://img.shields.io/badge/Python-3.10%2B-green)](https://www.python.org/)
[![License](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)
[![PyPI](https://img.shields.io/pypi/v/taskpriority-mcp)](https://pypi.org/project/taskpriority-mcp/)
[![npm](https://img.shields.io/npm/v/taskpriority-mcp)](https://www.npmjs.com/package/taskpriority-mcp)
[![Docker](https://img.shields.io/docker/v/greenblat17/mcp-server)](https://hub.docker.com/r/greenblat17/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](https://taskpriority.ai)

## 🚀 Quick Start

### 1. Install the Server

Choose one of these installation methods:

#### Option A: Install from PyPI (Recommended)

```bash
pip install taskpriority-mcp
```

#### Option B: Install from GitHub

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

#### Option C: Install from Source

```bash
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](https://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

```json
{
  "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](docs/configuration.md).

## 📚 Documentation

- [API Reference](docs/api-reference.md) - Detailed API documentation
- [Development Guide](docs/development.md) - Contributing and development setup
- [Deployment Guide](docs/deployment.md) - Production deployment instructions
- [Examples](examples/) - Code examples and use cases

## 🤝 Contributing

Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) 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](LICENSE) file for details.

## 🙏 Acknowledgments

- Built with the [Model Context Protocol](https://github.com/modelcontextprotocol/servers)
- Powered by [TaskPriority AI](https://taskpriority.ai)
- Integrated with [Claude Desktop](https://claude.ai)

## 📞 Support

- **Issues**: [GitHub Issues](https://github.com/yourusername/mcp-priority/issues)
- **Discussions**: [GitHub Discussions](https://github.com/yourusername/mcp-priority/discussions)
- **Email**: support@taskpriority.ai

---

Made with ❤️ by the TaskPriority team