Tasks MCP
Configure mcp client vscode
// For use with vscode and copilot
{
"servers": {
"tasks-mcp": {
"type": "stdio",
"command": "uv",
"args": [
"run",
"--directory",
"path-to/tasks-mcp",
"src/main.py"
],
"env": {
"TRANSPORT": "stdio"
},
}
},
"inputs": []
}
// For use with continue.dev extension
name: Tasks MCP Server
version: 0.0.1
schema: v1
mcpServers:
- name: Task MCP
command: uv
args:
- run
- --directory
- /path-to/tasks-mcp
- src/main.py
env: {
TRANSPORT: "stdio"
}
Runing server mode
// env variables
TRANSPORT=streamable-http
DATABASE_PATH=~/.tasks.sqlite3 # default data folrder on MCP project
HOST=0.0.0.0
PORT=8000
// Running local python server
make install
make run
// Run in docker
make docker.build
make docker.run
Common Natural Language Commands
You can interact with the Tasks MCP server using natural language commands. Here are some examples:
- Add a task with title {title} and description {description}
- Example: "Add task with title Buy groceries and description Get milk, eggs, and bread."
- List all tasks
- Example: "Show me all my tasks" or "List tasks created"
- Get details of a specific task
- Example: "Show details for task 2"
- Update a task's title or description
- Example: "Update task 3 with title Review project plan and description Check deadlines and deliverables."
- Change the status of a task
- Example: "Mark task 4 as in progress" or "Complete the task for dinner"
- Delete a task
- Example: "Delete task 5"
You can use these commands in English or Spanish. The system will interpret your intent and perform the requested action.
Libraries Used
This project uses the following main libraries:
- mcp[cli]: Provides the Model Context Protocol (MCP) server and CLI tools for building and running MCP-compatible agents and servers.
- pydantic-settings: For configuration management and environment variable parsing.
- sqlite3 (Python standard library): Used for local task data storage.
- dataclasses (Python standard library): For structured data models.
See pyproject.toml for the full list of dependencies.