How do I use Personal Task Manager MCP?

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

Personal Task Manager MCP

by aiarghya1

Overview Schema Source Related Servers Discussions Admin

Python

Local

Personal Task Manager — MCP Server

A Model Context Protocol (MCP) server that turns any AI assistant into a powerful task management system. Built with Python and SQLite, it exposes 19 tools for full lifecycle task management from quick to-dos to multi project workflows with priorities, tags, subtasks, and more.

AI Assistant  <-->  MCP Protocol (stdio)  <-->  Task Manager Server  <-->  SQLite DB

Features

Feature	Description
Due Dates & Deadlines	Set, update, or clear deadlines on any task
Priorities	Classify tasks as `high`, `medium`, or `low`
Status Workflow	Full lifecycle: `todo` > `in_progress` > `blocked` > `done` > `archived`
Tags & Labels	Flexible many-to-many tagging (e.g. `@work`, `@home`, `urgent`)
Notes & Descriptions	Rich markdown notes attached to any task
Subtasks & Checklists	Break tasks into ordered, toggleable checklist items
Lists & Projects	Organize tasks by context — work, personal, side-project

Related MCP server: tasq

All 19 MCP Tools

Core CRUD

Tool	Signature	Description
`get_schema`	`()`	Get the full database schema
`run_select_query`	`(query)`	Run a read-only SQL SELECT query
`add_task`	`(title, description?, due_date?, priority?, list_id?, notes?)`	Create a new task
`update_task`	`(task_id, title?, description?, status?, due_date?, priority?, list_id?, notes?)`	Update any task field
`delete_task`	`(task_id)`	Delete a task and its subtasks/tags

Due Dates

Tool	Signature	Description
`set_due_date`	`(task_id, due_date)`	Set or clear a deadline (YYYY-MM-DD)

Priorities

Tool	Signature	Description
`set_priority`	`(task_id, level)`	Set priority: `high` / `medium` / `low`

Status Workflow

Tool	Signature	Description
`set_status`	`(task_id, status)`	Set status: `todo` / `in_progress` / `blocked` / `done` / `archived`

Tags & Labels

Tool	Signature	Description
`add_tag`	`(task_id, tag)`	Add a tag to a task (creates if new)
`remove_tag`	`(task_id, tag)`	Remove a tag from a task
`list_by_tag`	`(tag)`	List all tasks with a given tag

Notes

Tool	Signature	Description
`update_notes`	`(task_id, markdown_text)`	Set/replace markdown notes on a task

Subtasks & Checklists

Tool	Signature	Description
`add_subtask`	`(parent_id, title)`	Add a checklist item to a task
`toggle_subtask`	`(subtask_id)`	Toggle completion (done / not done)
`delete_subtask`	`(subtask_id)`	Remove a subtask
`list_subtasks`	`(parent_id)`	List all subtasks of a task

Lists & Projects

Tool	Signature	Description
`create_list`	`(name, description?)`	Create a new list/project
`delete_list`	`(list_id)`	Delete a list (tasks become unassigned)
`move_task_to_list`	`(task_id, list_id)`	Move a task to a list (use `0` to unassign)
`list_tasks_in_list`	`(list_id)`	List all tasks in a list

Quick Start

Prerequisites

Python 3.10+
An MCP-compatible client (e.g. Claude Desktop, Cursor, VS Code + Copilot)

Installation

# Clone the repository
git clone https://github.com/arghyapolley/personal-task-manager-mcp.git
cd personal-task-manager-mcp

# Install dependencies
pip install -r requirements.txt

Run the Server

python server.py

The server communicates via stdio using the MCP protocol. It automatically creates/migrates the tasks.db SQLite database on startup.

Connect to Claude Desktop

Add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "task-manager": {
      "command": "python",
      "args": ["/absolute/path/to/server.py"]
    }
  }
}

Then restart Claude Desktop. You can now say things like:

"Add a high-priority task called 'Deploy v2' to my Work project, due May 10th"
"Show me all tasks tagged @urgent"
"Add subtasks to task 3: write tests, update docs, deploy"
"What's overdue?"

Database Schema

+---------------+       +---------------+
|    lists      |       |     tags      |
+---------------+       +---------------+
| id (PK)       |       | id (PK)       |
| name (UQ)     |       | name (UQ)     |
| description   |       +-------+-------+
| created_at    |               |
+-------+-------+               |
        |                +------+------+
        | 1:N            | task_tags   |
        |                +-------------+
+-------+-------+       | task_id(FK) |--+
|    tasks      |       | tag_id(FK)  |  |
+---------------+       +-------------+  |
| id (PK)       |<-----------------------+
| title         |
| description   |       +-------------+
| status        |       |  subtasks   |
| due_date      |       +-------------+
| priority      |  1:N  | id (PK)     |
| list_id (FK)  |<------| parent_id   |
| notes         |       | title       |
| created_at    |       |is_completed |
| updated_at    |       | sort_order  |
+---------------+       | created_at  |
                        +-------------+

Testing

Run the full test suite (63 tests, uses a temporary DB):

python test_server.py

  Results:  63 passed,  0 failed

Tests cover: schema creation, CRUD, priorities, status workflow, tags (add/remove/list/duplicates), notes, subtasks (add/toggle/delete/ordering), lists (create/move/unassign/delete), cascade deletes, and SQL injection guards.

Project Structure

personal-task-manager-mcp/
|-- server.py          # MCP server -- 19 tools, DB init, schema migration
|-- test_server.py     # Comprehensive test suite (63 assertions)
|-- requirements.txt   # Python dependencies (mcp, pydantic)
|-- tasks.db           # SQLite database (auto-created on first run)
+-- README.md          # This file

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Dazbench
app.dazbench
Task management your AI agents can actually run. One line becomes a context-ready task over MCP.
Autonomous Agents Project Management Agent Orchestration
1
https://mcp.dazbench.app/mcp
Superlist
io.github.superlistapp
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Project Management Workplace & Productivity
2
https://app.superlist.com/mcp
GetItDoneA
com.nowgetitdone
AI-native task management: list, create, update and archive tasks with rich context for AI agents
Autonomous Agents Project Management
21
https://app.nowgetitdone.com/api/mcp
Done BearA
com.donebear
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
Project Management App Automation
171
https://mcp.donebear.com/mcp

Related MCP Servers

MCP Project Manager
Project Management Databases
dhruv-vootkuri
F
license
A
quality
D
maintenance
Enables task management (create, list, update tasks with priority and status) using SQLite storage via MCP tools.
Updated 5 months ago (2026-06-18 21:25 UTC)
3
-
tasq
Project Management Autonomous Agents Developer Tools
ptucholski
A
license
B
quality
B
maintenance
A local-first task manager with SQLite backend, exposed as CLI, TUI, and MCP server. Enables AI assistants to manage tasks via tools for add, edit, search, plan, and more.
Updated 3 months ago (2026-08-21 15:10 UTC)
19
MIT
barrydo
Project Management App Automation
kingfisherfox
A
license
Not graded
quality
B
maintenance
Enables AI agents to create, read, and manage tasks and projects in a personal todo system through MCP tools.
Updated a month ago (2026-10-13 02:02 UTC)
1
MIT
taskboard-mcp
Project Management Developer Tools
fellam
A
license
Not graded
quality
C
maintenance
Enables deterministic, SQLite-backed task and todo tracking across multiple project scopes via MCP tools, allowing agents to add, update, list, complete, and delete tasks without hand-editing text files.
Updated 2 months ago (2026-09-08 22:12 UTC)
3 npm
MIT