How do I use todo-mcp?

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

todo-mcp

by Azibagirramani

Overview Schema Source Related Servers Discussions Admin

JavaScript

Local

todo-mcp

A simple todo list MCP server written in TypeScript. It exposes tools for managing a todo list to any MCP client (Claude Desktop, Claude Code, etc.). Todos are persisted to a JSON file on disk.

Tools

Tool	Description
`add_todo`	Add a new item (`text`)
`list_todos`	List items, optional `filter`: `all` \| `active` \| `completed`
`complete_todo`	Mark an item done/undone (`id`, optional `done`)
`delete_todo`	Delete an item (`id`)
`clear_completed`	Remove all completed items

Related MCP server: Task Manager MCP Server

Setup

npm install
npm run build

This compiles to build/index.js. By default todos are stored in ~/.todo-mcp.json; override with the TODO_FILE environment variable.

Connecting a client

Claude Code

claude mcp add todo -- node /Users/mansi/Documents/MCP/todo-list/build/index.js

Claude Desktop

Add to claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "todo": {
      "command": "node",
      "args": ["/Users/mansi/Documents/MCP/todo-list/build/index.js"]
    }
  }
}

Restart the client, then ask it to add, list, or complete todos.

Development

npm run dev    # tsc --watch

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Todo MCPA
io.github.AnkitPat
Create, list, and complete todo items through MCP.
Project Management Workplace & Productivity
1
https://343e-2405-201-303a-4980-a1c1-6538-33c0-a7d8.ngrok-free.app/mcp
tidee
com.tidee
Add items to your tidee workspace from ordinary language, read what is there, and mark things done.
Project Management Workplace & Productivity
1
https://app.tidee.com/mcp
Done BearA
com.donebear
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
Project Management App Automation
171
https://mcp.donebear.com/mcp
Taskbead
com.taskbead
Simple to-do lists for students and teams: list, search, add, update and complete tasks.
Project Management Workplace & Productivity
1
https://taskbead.com/mcp

Related MCP Servers

MCP Todo
Note Taking App Automation
CalamityAdam
A
license
B
quality
D
maintenance
Enables users to manage a persistent todo list through natural language, supporting adding, listing, toggling completion status, and removing todos. Features both stdio and HTTP transports with optional authentication and JSON file storage.
Updated a year ago (2025-09-14 05:31 UTC)
4
ISC
Task Manager MCP Server
App Automation Workplace & Productivity Project Management
MyLightIsOn
A
license
Not graded
quality
D
maintenance
Enables task management through natural language with full CRUD operations including add, list, update, complete, and delete tasks with JSON persistence.
Updated 10 months ago (2025-12-25 03:14 UTC)
ISC
Todokit MCP Server
App Automation Project Management Workplace & Productivity
j0hanz
A
license
A
quality
D
maintenance
A task management and productivity tool that enables creating, updating, filtering, and organizing todos with tags, priorities, and due dates, all stored locally in JSON format.
Updated 7 months ago (2026-04-11 17:42 UTC)
7
16 npm
MIT
Todo MCP Server
Project Management
X4MU-L
A
license
A
quality
D
maintenance
Enables AI assistants to manage a todo list with add, list, complete, and delete tasks.
Updated 10 months ago (2026-01-05 16:34 UTC)
4
3 npm
MIT

todo-mcp

Tools

Setup

Connecting a client

Claude Code

Claude Desktop

Development

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

MCP Todo

Task Manager MCP Server

Todokit MCP Server

Todo MCP Server