jvhy/tasks-mcp

Tasks MCP

A Model Context Protocol server that provides simple to-do task management tools.

Setup

Clone and install requirements:

$ git clone https://github.com/jvhy/tasks_mcp.git
$ uv sync

Create empty database:

$ uv pip install -e .
$ export SQLITE_DB_PATH=/path/to/database.db
$ uv run python3
>>> from tasks_mcp.models import Base
>>> from tasks_mcp.database import engine
>>> Base.metadata.create_all(engine)

Config for continue.dev

Add the following to .continue/config.yaml:

mcpServers:
  - name: Tasks MCP
    type: stdio
    command: uv
    args:
      - "--directory"
      - "/path/to/cloned/tasks_mcp/src/tasks_mcp"
      - run
      - __main__.py
    env:
      SQLITE_DB_PATH: /path/to/database.db

Schema

Task database has the following schema:

• id (int): Numeric id. Automatically created.
• title (str): Title of the task. Max 255 characters.
• description (str): Short description of the task. Max 1024 characters.
• created_at (datetime): Creation datetime. Automatically created.
• scheduled_for (datetime): Datetime when the task is due.
• priority (Enum): Task priority level. 1 = high, 2 = medium (default), 3 = low.
• status (Enum): Task completion status. Pending, Closed or Done.

Tools

Managing tasks:

• create_new_task
• mark_task_as_completed
• cancel_task
• reopen_task
• reschedule_task
• reprioritize_task

Reading tasks:

• list_tasks
• search_tasks_by_keywords
• filter_tasks_by_datetime
• filter_tasks_by_status
• filter_tasks_by_priority

Resources

• get_current_datetime - Get current time in system timezone as ISO 8601 string.

Example prompts

Note that when using relative date/time references you should provide the agent with the current datetime, either in system prompt or via @get_current_datetime.

1. "Create a new task for tomorrow at 1pm: 'Call John'. High priority. Add a reminder note to ask him about tomorrow's meeting slides."
2. "Reschedule all tomorrow's tasks forward by two days. Same times."
3. "What tasks do I have pending for today?"
4. "Do I have any open tasks related to our home renovation?"
5. "Cancel all tasks scheduled for next week.."

Notes

• This tool was tested with Qwen3 4b and 8b models at Q4 precision and the tool calling accuracy was acceptable. Larger models are likely even more reliable.
• Smaller models may struggle with relative datetimes (e.g. "next week") or hallucinate the current time when not provided. These can be alleviated with system prompts/rules.