README.md•2.29 kB
# Tasks MCP
### Configure mcp client vscode
```json
// 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": []
}
```
```yaml
// 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
```bash
// env variables
TRANSPORT=streamable-http
DATABASE_PATH=~/.tasks.sqlite3 # default data folrder on MCP project
HOST=0.0.0.0
PORT=8000
```
```bash
// Running local python server
make install
make run
```
```bash
// 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.