Todo MCP Server

What is Todo MCP Server?

A simple MCP (Model Context Protocol) server for managing todo items with SQLite database storage. It allows users to add, list, and remove todo items.

How to use Todo MCP Server?

Install dependencies with npm install, optionally configure the database location in src/database.ts, then build the project with npm run build. Use the provided tools (add-todo, get-todos, remove-todo) to manage todos.

Key features of Todo MCP Server

• Add new todo items
• List all todo items
• Remove todo items by ID
• SQLite database storage (configurable location)
• Built with TypeScript and MCP SDK

Use cases of Todo MCP Server

• Quickly add and track daily tasks
• Retrieve a list of all pending todos
• Remove completed or obsolete todo items
• Integrate todo management into MCP-enabled workflows

FAQ from Todo MCP Server

What tools does Todo MCP Server provide?

It provides three tools: add-todo (add a new item with a text string), get-todos (list all items), and remove-todo (remove an item by its numeric ID).

How do I configure the database location?

Open src/database.ts and modify the DB_LOCATION variable. Examples include "C:/todos" (Windows), join(homedir(), "todos") (macOS/Linux), or join(process.cwd(), "data") (current directory).

What are the runtime dependencies?

The server requires Node.js, the better-sqlite3 package for SQLite, and the @modelcontextprotocol/sdk. These are installed via npm install.

Does the database file need to exist beforehand?

No. The database file and its directory are automatically created if they don't already exist.

How is data stored?

Data is stored in a local SQLite database file. By default, the file is at C:/todos/todos.db (on Windows) or a user‑configurable location.