Skip to main content
Glama
Sign In
todo-mcp

todo-mcp

by Azibagirramani
OverviewSchemaSourceRelated ServersDiscussionsAdmin
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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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

    Related MCP Servers