Todo MCP Server

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).