Claude Todo Emulator

🚀 Claude Todo MCP Server

Enhance any AI coding assistant in Cursor, Windsurf, and other IDEs with persistent task management capabilities.

This MCP server emulates Claude Code's todo system, empowering your AI assistant to:

• Track intricate multi - step tasks across different sessions.
• Decompose large features into manageable segments.
• Recall progress when switching between projects.
• Enforce focus on a single in - progress task.

Why You Need This

Without task management, AI assistants suffer from several drawbacks:

• ❌ They forget their ongoing work between conversations.
• ❌ They lose track of multi - step implementations.
• ❌ They can't prioritize or organize complex work.
• ❌ They leave tasks half - finished when you change contexts.

With this MCP server, you get the following benefits:

• ✅ Persistent Memory: Tasks persist across sessions.
• ✅ Project - Scoped: Each workspace has its own todo list.
• ✅ Automatic Tracking: The AI knows when to create or update tasks.
• ✅ Progress Visibility: You can clearly see what's completed and what's pending.
• ✅ Focus Enforcement: Only one task can be in progress at a time.

🚀 Quick Start

No installation is required! Simply add the following 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 it to your MCP configuration file.

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

The system will automatically download the package and set everything up on first use!

💻 Usage Examples

Basic Usage

Once configured, your AI assistant will automatically perform the following tasks:

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."

📚 Documentation

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

1. Fork the repository.
2. Create a feature branch.
3. Add tests for new functionality.
4. Submit a pull request.

📄 License

This project is under the MIT License. See the LICENSE file for details.

🔗 Related Projects

• Model Context Protocol
• FastMCP
• Claude Code