MCP Todo Server
A simple Model Context Protocol (MCP) server that provides todo list management functionality to Claude Desktop and other MCP clients.
Features
Create todos with optional due dates
List all todos sorted by creation date
Toggle todo completion status
Delete todos by ID
Search todos by title
SQLite database with Prisma ORM for reliable concurrent operations
Installation
Setup
Create a
.env
file in the project root:
Initialize the database:
Configure Claude Desktop by adding this to
~/Library/Application Support/Claude/claude_desktop_config.json
:
Restart Claude Desktop
Project Structure
Available MCP Tools
list_todos
Returns all todos sorted by creation date (newest first).
add_todo
Creates a new todo item.
title
(string, required): The todo titledue
(string, optional): Due date
toggle_todo
Toggles or sets the completion status of a todo.
id
(string, required): Todo IDdone
(boolean, optional): Set specific state, or omit to toggle
delete_todo
Deletes a todo by ID.
id
(string, required): Todo ID
search_todos
Search todos by title substring.
q
(string, required): Search query
Development
Run the MCP server directly:
Test with a JSON-RPC message:
Debug with MCP Inspector
Use the MCP Inspector to test and debug your server interactively:
This opens a web interface where you can test all available tools and see real-time request/response data.
Database
The project uses SQLite with Prisma ORM. The database file is stored at data/todos.db
.
Schema
Migrations
Next.js Web UI (Optional)
This project also includes a Next.js web interface for managing todos.
Getting Started
Run the development server:
Open http://localhost:3000 with your browser to see the result.
You can start editing the page by modifying src/app/page.tsx
. The page auto-updates as you edit the file.
Deploy on Vercel
The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.
Check out the Next.js deployment documentation for more details.
Tech Stack
MCP SDK: @modelcontextprotocol/sdk
Database: SQLite + Prisma
Runtime: Node.js with tsx for TypeScript execution
Frontend (optional): Next.js 15, React 19, Tailwind CSS
License
MIT
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Enables Claude to manage todo lists with full CRUD operations including creating, listing, toggling completion status, deleting, and searching todos. Uses SQLite database with Prisma ORM for reliable data persistence and includes optional due date functionality.