Todo List MCP Server
About
An MCP server for managing todos within LLMs, created for educational purposes
Details
- Author
- RegiByte
- GitHub stars
- 45
- Downloads
- 517
- Categories
- Productivity, Project Management
Jump to
- Create todos with title and markdown description
- Update existing todo items
- Mark todos as completed
- Delete todos from the list
- Search todos by title (case-insensitive partial match)
- Search todos by creation date (YYYY-MM-DD format)
- List all non-completed todos
- Generate a summary of active todos
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Todo List MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, install dependencies with npm install, build with npm run build, and start with npm start. Configure it as an MCP server in Claude for Desktop or Cursor by adding the absolute path to the built dist/index.js file to the mcpServers configuration. The server exposes ten tools such as create-todo, list-todos, complete-todo, search-todos-by-title, search-todos-by-date, list-active-todos, and summarize-active-todos.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"todo list mcp server": {
"todo": {
"command": "node",
"args": [
"/absolute/path/to/todo-list-mcp/dist/index.js"
]
}
}
}
}McpServers
{
"todo": {
"command": "node",
"args": [
"/absolute/path/to/todo-list-mcp/dist/index.js"
]
}
}A Model Context Protocol (MCP) server that provides a comprehensive API for managing todo items.
📚 Learning Resource: This project is designed as an educational example of MCP implementation. SeeGUIDE.mdfor a comprehensive explanation of how the project works and why things are implemented the way they are.
- Create todos: Add new tasks with title and markdown description
- Update todos: Modify existing tasks
- Complete todos: Mark tasks as done
- Delete todos: Remove tasks from the list
- Search todos: Find tasks by title or creation date
- Summarize todos: Get a quick overview of active tasks
This MCP server exposes the following tools:
- create-todo: Create a new todo item
- list-todos: List all todos
- get-todo: Get a specific todo by ID
- update-todo: Update a todo's title or description
- complete-todo: Mark a todo as completed
- delete-todo: Delete a todo
- search-todos-by-title: Search todos by title (case-insensitive partial match)
- search-todos-by-date: Search todos by creation date (format: YYYY-MM-DD)
- list-active-todos: List all non-completed todos
- summarize-active-todos: Generate a summary of all active (non-completed) todos
# Clone the repository git clone https://github.com/RegiByte/todo-list-mcp.git cd todo-list-mcp # Install dependencies npm install # Build the project npm run build
Add this to yourclaude_desktop_config.json:
{ "mcpServers": { "todo": { "command": "node", "args": ["/absolute/path/to/todo-list-mcp/dist/index.js"] } } }
- Go to "Cursor Settings" -> MCP
- Add a new MCP server with a "command" type
- Add the absolute path of the server and run it with node
- Example: node /absolute/path/to/todo-list-mcp/dist/index.js
When using with Claude for Desktop or Cursor, you can try:
- "Create a todo to learn MCP with a description explaining why MCP is useful"
- "List all my active todos"
- "Create a todo for tomorrow's meeting with details about the agenda in markdown"
- "Mark my learning MCP todo as completed"
- "Summarize all my active todos"
This project follows a clear separation of concerns to make the code easy to understand:
src/ ├── models/ # Data structures and validation schemas ├── services/ # Business logic and database operations ├── utils/ # Helper functions and formatters ├── config.ts # Configuration settings ├── client.ts # Test client for local testing └── index.ts # Main entry point with MCP tool definitions
This project is designed as an educational resource. To get the most out of it:
- Read theGUIDE.mdfor a comprehensive explanation of the design
- Study the heavily commented source code to understand implementation details
- Use the test client to see how the server works in practice
- Experiment with adding your own tools or extending the existing ones
Interact with task, doc, and project data in Dart, an AI-native project management tool
Remote MCP server for MeisterTask. Create and manage projects, tasks, and notes from your AI assistant. Hosted (streamable-HTTP) — connect at https://mcp.meistertask.com/mcp
Remote MCP server for MindMeister. Create, edit, and organize mind maps from your AI assistant. Hosted (streamable-HTTP) — connect at https://mcp.mindmeister.com/mcp
The official Plane MCP server provides integration with Plane APIs, enabling full AI automation of Plane projects, work items, cycles and more.
MCP server to interact with Routine: calendars, tasks, notes, etc.
Keep teams & agents coordinated automatically
From the creators of Wunderlist — the all-in-one task management app for to-do lists, notes, and projects. AI-powered productivity that replaces 5 apps.
Connect to the Taskade platform via MCP. Access tasks, projects, workflows, and AI agents in real-time through a unified workspace and API.
Official Taskeract MCP Server for integrating your Taskeract project tasks and load the context of your tasks into your MCP enabled app.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
