# TaskPriority MCP Server
[](https://github.com/modelcontextprotocol/servers)
[](https://www.python.org/)
[](LICENSE)
[](https://pypi.org/project/taskpriority-mcp/)
[](https://www.npmjs.com/package/taskpriority-mcp)
[](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
Raw data
{
"_id": null,
"home_page": "https://github.com/greenblat17/mcp-priority",
"name": "taskpriority-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "mcp, claude, taskpriority, ai, task-management",
"author": "TaskPriority Team",
"author_email": "TaskPriority Team <support@taskpriority.ai>",
"download_url": "https://files.pythonhosted.org/packages/7f/3f/977b575df0772b639955a41c772e2dcb2e1ccb8b797c6ffef8ed03fb4349/taskpriority_mcp-1.2.0.tar.gz",
"platform": null,
"description": "# TaskPriority MCP Server\n\n[](https://github.com/modelcontextprotocol/servers)\n[](https://www.python.org/)\n[](LICENSE)\n[](https://pypi.org/project/taskpriority-mcp/)\n[](https://www.npmjs.com/package/taskpriority-mcp)\n[](https://hub.docker.com/r/greenblat17/mcp-server)\n\nAn 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.\n\n## \ud83c\udf1f Features\n\n- **AI-Powered Task Analysis**: Automatic priority scoring (1-10), complexity assessment, and time estimation\n- **Smart Task Management**: Create, update, list, and delete tasks with full CRUD operations\n- **Similarity Detection**: Identifies duplicate and related tasks to prevent redundancy\n- **Real-time Analysis**: Get instant AI insights when creating or analyzing tasks\n- **MCP Integration**: Seamlessly works with Claude Desktop for natural language task management\n\n## \ud83d\udccb Prerequisites\n\n- Python 3.10 or higher\n- Claude Desktop (for MCP integration)\n- TaskPriority API key from [taskpriority.ai](https://taskpriority.ai)\n\n## \ud83d\ude80 Quick Start\n\n### 1. Install the Server\n\nChoose one of these installation methods:\n\n#### Option A: Install from PyPI (Recommended)\n\n```bash\npip install taskpriority-mcp\n```\n\n#### Option B: Install from GitHub\n\n```bash\npip install git+https://github.com/greenblat17/priority-mcp.git\n```\n\n#### Option C: Install from Source\n\n```bash\ngit clone https://github.com/greenblat17/priority-mcp.git\ncd mcp-priority\npip install -e .\n```\n\n### 2. Get Your API Key\n\n1. Sign up at [taskpriority.ai](https://taskpriority.ai)\n2. Go to Settings \u2192 API Keys\n3. Create a new key (starts with `tp_live_`)\n\n### 3. Configure Claude Desktop\n\nFind your Claude Desktop configuration file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` \n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json` \n**Linux**: `~/.config/Claude/claude_desktop_config.json`\n\nAdd this configuration\n\n```json\n{\n \"mcpServers\": {\n \"taskpriority\": {\n \"command\": \"taskpriority-mcp\",\n \"env\": {\n \"TASKPRIORITY_API_KEY\": \"tp_live_your_api_key_here\"\n }\n }\n }\n}\n```\n\n### 4. Restart Claude Desktop\n\nCompletely quit and restart Claude Desktop for the changes to take effect.\n\n## \ud83d\udca1 Usage\n\nOnce configured, you can use natural language commands in Claude Desktop:\n\n### Creating Tasks\n\n```\n\"Create a task to implement user authentication\"\n\"Add a bug report about the login page not loading\"\n\"New task: Improve database query performance\"\n```\n\n### Listing Tasks\n\n```\n\"Show me all my pending tasks\"\n\"List high-priority bugs\"\n\"What tasks are in progress?\"\n```\n\n### Updating Tasks\n\n```\n\"Mark task 123e4567 as completed\"\n\"Update the authentication task to in-progress\"\n\"Change the priority of the database task\"\n```\n\n### Getting AI Analysis\n\n```\n\"Analyze task 123e4567\"\n\"What's the time estimate for the authentication task?\"\n\"Show me tasks similar to implementing payment processing\"\n```\n\n## \ud83d\udee0\ufe0f Available MCP Tools\n\n### `create_task`\n\nCreates a new task with automatic AI analysis.\n\n**Parameters:**\n\n- `description` (required): Task description\n- `source` (optional): Origin of the task (default: \"internal\")\n- `customer_info` (optional): Additional context\n\n### `list_tasks`\n\nLists tasks with filtering options.\n\n**Parameters:**\n\n- `status` (optional): Filter by status (pending, in_progress, completed, blocked)\n- `category` (optional): Filter by category (bug, feature, improvement, business, other)\n- `limit` (optional): Number of results (default: 50, max: 100)\n- `offset` (optional): Pagination offset (default: 0)\n\n### `get_task_details`\n\nRetrieves complete information about a specific task.\n\n**Parameters:**\n\n- `task_id` (required): UUID of the task\n\n### `update_task`\n\nUpdates an existing task.\n\n**Parameters:**\n\n- `task_id` (required): UUID of the task\n- `status` (optional): New status\n- `description` (optional): Updated description\n- `customer_info` (optional): Updated customer information\n\n### `delete_task`\n\nDeletes a task permanently.\n\n**Parameters:**\n\n- `task_id` (required): UUID of the task\n\n### `get_ai_analysis`\n\nGets or waits for AI analysis of a task.\n\n**Parameters:**\n\n- `task_id` (required): UUID of the task\n- `timeout` (optional): Max seconds to wait for analysis (default: 30)\n\n## \ud83d\udd27 Configuration\n\n### Environment Variables\n\n| Variable | Description | Default | Required |\n| -------------------------- | -------------------------- | ----------------------------- | -------- |\n| `TASKPRIORITY_API_KEY` | Your TaskPriority API key | - | Yes |\n| `TASKPRIORITY_API_URL` | TaskPriority API base URL | `https://api.taskpriority.ai` | No |\n| `TASKPRIORITY_API_VERSION` | API version | `v1` | No |\n| `TASKPRIORITY_TIMEOUT` | Request timeout in seconds | `30` | No |\n| `DEBUG_MODE` | Enable debug logging | `false` | No |\n\n### Advanced Configuration\n\nFor advanced configuration options, see the [Configuration Guide](docs/configuration.md).\n\n## \ud83d\udcda Documentation\n\n- [API Reference](docs/api-reference.md) - Detailed API documentation\n- [Development Guide](docs/development.md) - Contributing and development setup\n- [Deployment Guide](docs/deployment.md) - Production deployment instructions\n- [Examples](examples/) - Code examples and use cases\n\n## \ud83e\udd1d Contributing\n\nContributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## \ud83d\ude4f Acknowledgments\n\n- Built with the [Model Context Protocol](https://github.com/modelcontextprotocol/servers)\n- Powered by [TaskPriority AI](https://taskpriority.ai)\n- Integrated with [Claude Desktop](https://claude.ai)\n\n## \ud83d\udcde Support\n\n- **Issues**: [GitHub Issues](https://github.com/yourusername/mcp-priority/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/yourusername/mcp-priority/discussions)\n- **Email**: support@taskpriority.ai\n\n---\n\nMade with \u2764\ufe0f by the TaskPriority team\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "MCP server for intelligent task prioritization with Claude Desktop",
"version": "1.2.0",
"project_urls": {
"Documentation": "https://github.com/yourusername/mcp-priority#readme",
"Homepage": "https://github.com/yourusername/mcp-priority",
"Issues": "https://github.com/yourusername/mcp-priority/issues",
"Repository": "https://github.com/yourusername/mcp-priority.git"
},
"split_keywords": [
"mcp",
" claude",
" taskpriority",
" ai",
" task-management"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "835e4e5bd8caacb029665ba378e85987023adc0492058057f6e5a0679a115d5e",
"md5": "7551ec5702267d1ed9c2e2576f75d403",
"sha256": "be3f5d8658db9cb5bfbb727959ed9864a0f1b71562b91fc30a4e7c20843568ba"
},
"downloads": -1,
"filename": "taskpriority_mcp-1.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7551ec5702267d1ed9c2e2576f75d403",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 25031,
"upload_time": "2025-08-04T05:11:13",
"upload_time_iso_8601": "2025-08-04T05:11:13.516732Z",
"url": "https://files.pythonhosted.org/packages/83/5e/4e5bd8caacb029665ba378e85987023adc0492058057f6e5a0679a115d5e/taskpriority_mcp-1.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "7f3f977b575df0772b639955a41c772e2dcb2e1ccb8b797c6ffef8ed03fb4349",
"md5": "6fd339c1750d57d3ef6242b357203e2b",
"sha256": "13c4c0a3a64a504f22b908b3400d4eb495f97f37eb44959e5cf8fddea0a96fd9"
},
"downloads": -1,
"filename": "taskpriority_mcp-1.2.0.tar.gz",
"has_sig": false,
"md5_digest": "6fd339c1750d57d3ef6242b357203e2b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 80427,
"upload_time": "2025-08-04T05:11:14",
"upload_time_iso_8601": "2025-08-04T05:11:14.929532Z",
"url": "https://files.pythonhosted.org/packages/7f/3f/977b575df0772b639955a41c772e2dcb2e1ccb8b797c6ffef8ed03fb4349/taskpriority_mcp-1.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-04 05:11:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "greenblat17",
"github_project": "mcp-priority",
"github_not_found": true,
"lcname": "taskpriority-mcp"
}
JSON
