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.