Overview
What is Todo MCP Server?
A simple MCP (Model Context Protocol) server for managing todo items with SQLite database storage. It is intended for users who want to integrate basic todo operations into MCP-compatible applications.
How to use Todo MCP Server?
Install dependencies with npm install, optionally configure the database location by editing the DB_LOCATION variable in src/database.ts, build the project with npm run build, then invoke the server. Available tools are add-todo (string text), get-todos (no parameters), and remove-todo (number id).
Key features of Todo MCP Server
- Add new todo items with text content.
- List all stored todo items.
- Remove a todo item by its numeric ID.
- Uses SQLite for persistent storage.
- Database and directory auto-created if missing.
Use cases of Todo MCP Server
- Adding a new task to a personal checklist.
- Retrieving all current tasks for review.
- Deleting a completed or unwanted task.
FAQ from Todo MCP Server
How do I configure the database location?
Open src/database.ts and modify the DB_LOCATION variable. Examples include "C:/todos" (Windows) or join(homedir(), "todos") (macOS/Linux).
What database technology does Todo MCP Server use?
It uses SQLite via the better-sqlite3 npm package.
What is the default database path?
The default database file is C:/todos/todos.db. The directory and file are created automatically if they do not exist.
How do I add a todo item?
Use the add-tool command with a text parameter, for example: add-todo(text: "Buy groceries").
How do I remove a todo item?
Use the remove-todo command with the item’s id parameter, for example: remove-todo(id: 1).
