surong15/todo-mcp-server

Todo MCP Server

A personal to-do list MCP Server that enables AI assistants to manage your tasks. (All code originally generated by Claude.)

Features

• Add, edit, and delete tasks
• Set priority (High / Medium / Low)
• Task category management
• Task search functionality
• Mark tasks as completed or not completed
• Set due dates
• Local SQLite database storage

Installation

1. Install dependencies

npm install

2. Build TypeScript

npm run build

3. Test functionality

node test.js

Configure Claude Desktop

1. Locate Claude Desktop config:

• macOS:
  ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows:
  %APPDATA%\Claude\claude_desktop_config.json

2. Add the MCP server configuration:

{
  "mcpServers": {
    "todo": {
      "command": "node",
      "args": ["/path/to/your/todo-mcp-server/dist/server.js"],
      "cwd": "/path/to/your/todo-mcp-server"
    }
  }
}

3. Restart Claude Desktop

Usage

Start the MCP server with:

node dist/server.js

Add a task

Add a new task: finish project report, priority high, category work

View task list

Show all my incomplete tasks

Mark as completed

Mark task ID 1 as completed

Search tasks

Search tasks that contain "report"

Update a task

Update task 2 title to "Buy household items"

Delete a task

Delete task ID 3

Available MCP Tools

Database Location

Task data is stored in:

data/todo.db

You may:

• Back up this file to preserve your data
• Delete it to reset the database
• View or edit it using any SQLite tool

Development

• npm run dev — Compile and run
• npm run build — Build only
• npm run clean — Remove build artifacts