Claude Todo MCP Server

Add persistent task management to any AI coding assistant in Cursor, Windsurf, and other IDEs.

This MCP server replicates Claude Code's todo system, giving your AI assistant the ability to:

Track complex multi-step tasks across sessions
Break down large features into manageable pieces
Remember progress when you switch between projects
Enforce single in-progress task focus

Why You Want This

Without task management, AI assistants:

❌ Forget what they were working on between conversations
❌ Lose track of multi-step implementations
❌ Can't prioritize or organize complex work
❌ Leave tasks half-finished when you switch contexts

With this MCP server:

✅ Persistent memory - Tasks survive across sessions
✅ Project-scoped - Each workspace gets its own todo list
✅ Automatic tracking - AI knows when to create/update tasks
✅ Progress visibility - See exactly what's completed/pending
✅ Focus enforcement - Only one task in-progress at a time

Quick Start

No installation required! Just add this to your MCP configuration:

{
  "mcpServers": {
    "task-manager": {
      "command": "uvx",
      "args": ["claude-todo-emulator"]
    }
  }
}

Cursor: Create .cursor/mcp.json in your project root
Other IDEs: Add to your MCP configuration file

Restart your IDE and try: "Create a todo list for adding user authentication"

The system automatically downloads the package and sets up everything on first use!

What You Get

Once configured, your AI assistant will automatically:

Create todos for complex tasks:

You: "Add dark mode support with user preferences"
AI: "I'll create a todo list for this multi-step feature:
- ✅ Add theme context and state management
- 🔄 Create dark mode CSS variables and styles
- ⏳ Build settings UI for theme switching
- ⏳ Add persistence to localStorage
- ⏳ Update existing components for theme support"

Track progress visually:

You: "What's the status on the authentication system?"
AI: "Current authentication tasks:
- ✅ Set up JWT middleware
- ✅ Create login/signup endpoints
- 🔄 Building user profile management (in progress)
- ⏳ Add password reset flow
- ⏳ Implement role-based permissions"

Maintain focus:

You: "Let's also add email notifications"
AI: "I'll add that to the todo list, but let me finish the current user profile task first to maintain focus."

API Reference

TodoRead

Parameters: None
Returns: {todos: Todo[]}

TodoWrite

Parameters: {todos: Todo[]}
Returns: {success: boolean, count: number}

Todo Schema

{
  id: string;
  content: string;
  status: "pending" | "in_progress" | "completed";
  priority: "high" | "medium" | "low";
  created_at: string;
  updated_at: string;
  metadata?: object;
}

Contributing

Fork the repository
Create a feature branch
Add tests for new functionality
Submit a pull request

License

MIT License - see LICENSE file for details.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

Tools

Adds persistent task management to AI coding assistants in IDEs, allowing them to track multi-step tasks across sessions and maintain organized workflow with project-scoped todo lists.

Related Resources

Reddit Discussion about this server

Related MCP Servers

CodeSavant
twolven
-
security
A
license
-
quality
Provides code manipulation, execution, and version control capabilities. It allows AI assistants to read, write, and execute code while maintaining a history of changes.
Last updated -
8
Python
MIT License
Project Handoffs MCP Server
davidorex
A
security
F
license
A
quality
Facilitates AI session handoffs and next steps tracking through project-based organization, supporting task prioritization and seamless workflow management.
Last updated -
8
6
JavaScript
Pippa MCP Memory Manager
neobundy
-
security
F
license
-
quality
A comprehensive memory management system for Cursor IDE that allows AI assistants to remember, recall, and manage information across conversations through a user-friendly interface.
Last updated -
2
Python
Tiny TODO MCP
tkc
-
security
F
license
-
quality
A Model Context Protocol server that provides persistent task management capabilities for AI assistants, allowing them to create, update, and track tasks beyond their usual context limitations.
Last updated -
1
TypeScript

View all related MCP servers

Claude Todo MCP Server