home / mcp / todo mcp server

Todo MCP Server

Provides a robust MCP server to manage todos with create, list, update, delete, and analytics tools, plus resources and prompts.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "cateland-poc_todo_mcp_server": {
      "command": "node",
      "args": [
        "/path/to/your/todo-mcp-server/dist/index.js"
      ]
    }
  }
}

You can run a modern MCP server to manage todos with clear capabilities, robust error handling, and flexible integration points. This server exposes tools to create, list, update, and delete todos, plus analytics and prompts to help you stay productive—all accessible through a consistent MCP API that your clients can connect to and discover at runtime.

How to use

Connect your MCP client to the server named Todo Manager to access a full set of todo-management capabilities. You can discover available tools, resources, and prompts, then invoke them to create todos, list and filter by status or priority, update fields including completion and metadata, remove items, or generate statistics and summaries. Use natural language prompts to generate daily reports or intelligent task prioritization, and read structured data through the available resources.

How to install

Prerequisites: ensure you have Node.js 18+ and npm or yarn installed. Familiarity with TypeScript is optional for usage.

1. Clone the project repository.

2. Install dependencies.

3. Build the TypeScript project.

4. Optionally test with the MCP Inspector.

5. Configure your MCP client to connect to the server.

Configuration

Configure your MCP client to launch the server locally via a standard IO (stdio) process. The following example shows how to start the server using Node.js and the built output.

Configuration details for your MCP client

{
  "mcpServers": {
    "todo-manager": {
      "command": "node",
      "args": ["/path/to/your/todo-mcp-server/dist/index.js"],
      "env": {},
      "cwd": "/path/to/your/todo-mcp-server"
    }
  }
}

Usage examples

After connecting, you can issue natural language requests such as: Create a high-priority todo, list all high-priority pending todos, or mark a task as completed. You can also ask for a daily report, prioritize pending tasks, or generate a professional productivity summary.

Development notes

The server follows modern MCP SDK patterns, with capabilities discovered automatically based on registered tools, resources, and prompts. It emphasizes robust error handling, async operations, and clean lifecycle management to ensure stable operation in production.

Troubleshooting

If you encounter startup errors, verify that the runtime command points to your built index and that the working directory is correct. Check logs for unhandled rejections or validation errors and ensure environment variables (if any) are properly provided.

Example configuration blocks for clients

The following client configuration blocks show how to integrate the server with two common MCP clients. They assume you are running locally and that the server artifact is built to dist/index.js.

Cursor IDE configuration

{
  "mcp-servers": {
    "todo-manager": {
      "command": "node",
      "args": ["/path/to/your/todo-mcp-server/dist/index.js"],
      "env": {},
      "cwd": "/path/to/your/todo-mcp-server"
    }
  }
}

Claude Desktop configuration

{
  "mcpServers": {
    "todo-manager": {
      "command": "node",
      "args": ["/path/to/your/todo-mcp-server/dist/index.js"]
    }
  }
}

Available tools

create_todo

Create new todos with title, description, priority levels, and tags

list_todos

List and filter todos by status (completed/pending), priority, and tags

update_todo

Update any todo field including completion status and metadata

delete_todo

Remove todos by ID with confirmation

todo_stats

Generate comprehensive statistics and analytics