Task MCP Server
A simple task management Model Context Protocol (MCP) server for Claude Desktop.
Features
- ✅ Add new tasks
- 📋 List all tasks
- ✓ Mark tasks as completed
- 🗑️ Delete tasks
Installation
From GitHub (Recommended)
The easiest way to use this server is directly from GitHub using uvx:
{
"mcpServers": {
"task-manager": {
"command": "uvx",
"args": [
"task-mcp-server",
"--from",
"git+https://github.com/YOUR_USERNAME/task-mcp-server.git"
]
}
}
}
Local Installation
# Clone the repository
git clone https://github.com/YOUR_USERNAME/task-mcp-server.git
cd task-mcp-server
# Install with uv
uv pip install -e .
# Run the server
task-mcp-server
Usage with Claude Desktop
-
Open Claude Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
-
Add the server configuration:
{
"mcpServers": {
"task-manager": {
"command": "uvx",
"args": [
"task-mcp-server",
"--from",
"git+https://github.com/YOUR_USERNAME/task-mcp-server.git"
]
}
}
}
-
Restart Claude Desktop
-
Look for the 🔌 icon to confirm the server is connected
Available Tools
- add_task: Add a new task with title and optional description
- list_tasks: Display all tasks with their status
- complete_task: Mark a task as completed
- delete_task: Remove a task from the list
Example Usage
In Claude Desktop, try:
- "Add a task to buy groceries"
- "List all my tasks"
- "Mark task 1 as completed"
- "Delete task 2"
Development
# Install dependencies
uv pip install -e .
# Run locally
uv run task-mcp-server
# Test with MCP inspector
npx @modelcontextprotocol/inspector uv run task-mcp-server
License
MIT