# TaskPriority MCP Server
[](https://github.com/modelcontextprotocol/servers)
[](https://www.python.org/)
[](LICENSE)
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/yourusername/mcp-priority.git
```
#### Option C: Install from Source
```bash
git clone https://github.com/yourusername/mcp-priority.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/yourusername/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/82/5d/7274d9926dd3e46461d8e10257ded4716e8d5db937cce9169f8cbe234db3/taskpriority_mcp-1.0.0.tar.gz",
"platform": null,
"description": "# TaskPriority MCP Server\n\n[](https://github.com/modelcontextprotocol/servers)\n[](https://www.python.org/)\n[](LICENSE)\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```bash\npip install taskpriority-mcp\n```\n\n#### Option B: Install from GitHub\n```bash\npip install git+https://github.com/yourusername/mcp-priority.git\n```\n\n#### Option C: Install from Source\n```bash\ngit clone https://github.com/yourusername/mcp-priority.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`\nCreates a new task with automatic AI analysis.\n\n**Parameters:**\n- `description` (required): Task description\n- `source` (optional): Origin of the task (default: \"internal\")\n- `customer_info` (optional): Additional context\n\n### `list_tasks`\nLists tasks with filtering options.\n\n**Parameters:**\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`\nRetrieves complete information about a specific task.\n\n**Parameters:**\n- `task_id` (required): UUID of the task\n\n### `update_task`\nUpdates an existing task.\n\n**Parameters:**\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`\nDeletes a task permanently.\n\n**Parameters:**\n- `task_id` (required): UUID of the task\n\n### `get_ai_analysis`\nGets or waits for AI analysis of a task.\n\n**Parameters:**\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.0.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": "8b448856661d069d1bec3217cd787518f7fae8cda0e05a6b51d09bdbefca55e1",
"md5": "eb3510f2a2ea7818afecdeaa835ab9d3",
"sha256": "495cd437f55efcc0c3e489c02bbdb108d61235326bda518ba30dc19aad174f05"
},
"downloads": -1,
"filename": "taskpriority_mcp-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "eb3510f2a2ea7818afecdeaa835ab9d3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 24301,
"upload_time": "2025-08-02T13:37:25",
"upload_time_iso_8601": "2025-08-02T13:37:25.715286Z",
"url": "https://files.pythonhosted.org/packages/8b/44/8856661d069d1bec3217cd787518f7fae8cda0e05a6b51d09bdbefca55e1/taskpriority_mcp-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "825d7274d9926dd3e46461d8e10257ded4716e8d5db937cce9169f8cbe234db3",
"md5": "d06e6de156e01f906dcfbde5f0646e60",
"sha256": "577c40f30a04b157d42356a94bca635ea4a4e2c992461f681809a8a3ff1c94ee"
},
"downloads": -1,
"filename": "taskpriority_mcp-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "d06e6de156e01f906dcfbde5f0646e60",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 72874,
"upload_time": "2025-08-02T13:37:26",
"upload_time_iso_8601": "2025-08-02T13:37:26.974935Z",
"url": "https://files.pythonhosted.org/packages/82/5d/7274d9926dd3e46461d8e10257ded4716e8d5db937cce9169f8cbe234db3/taskpriority_mcp-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-02 13:37:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yourusername",
"github_project": "mcp-priority",
"github_not_found": true,
"lcname": "taskpriority-mcp"
}
JSON
