V1997/To-Do-Manager-MCP-Server

To-Do Manager MCP Server

A server for managing to-do items via the Model Context Protocol (MCP). Designed for integration with AI assistants and MCP-compatible clients. Provides persistent, auto-expiring to-do storage using Redis and is deployable on Vercel.

Project Description

This project implements a to-do manager API with add, list, update, and delete operations. It is intended for use with MCP clients and AI tools, and is suitable as a reference or starting point for MCP-based integrations.

Features

• Add, list, update, and delete to-do items
• Auto-expiry: to-dos are deleted after 3 hours
• Persistent storage using Redis
• MCP protocol support for AI and automation workflows
• Deployable on Vercel

Claude Desktop AI Integration

To use this To-Do Manager MCP Server with Claude Desktop AI, add the following block to your mcp.json configuration file:

{
  "mcpServers": {
    "to-do-manager": {
      "url": "https://to-do-manager-mcp-server.vercel.app/mcp"
    }
  }
}

This will enable Claude Desktop AI to interact directly with your to-do manager server.

Installation

1. Clone the repository:

   git clone https://github.com/V1997/To-Do-Manager-MCP-Server.git
   cd To-Do-Manager-MCP-Server
   

2. Install dependencies:

   npm install
   

3. Configure Redis:
   • Use a managed Redis service (Upstash, Redis Cloud, or Vercel Redis integration).
   • Add your Redis connection string to .env.local:

     REDIS_URL=your_redis_connection_url
     

4. Start the development server:

   npm run dev
   

   The server will be available at http://localhost:3000

Deployment & Technical Details

Vercel Deployment

• Connect your GitHub repository to Vercel.
• Set the REDIS_URL environment variable in Vercel project settings.
• Vercel will build and deploy on each push to the main branch.
• The application will be available at a Vercel-provided URL.

Redis Usage

• Each to-do is stored as a Redis hash (todo:{id}) with fields: id, text, completed, createdAt.
• A Redis list (todos) maintains the order of to-do IDs.
• All Redis operations are performed per request; the Redis client is created and closed in each handler for serverless compatibility.

Auto-Expiry

• When a to-do is created, a 3-hour TTL is set using Redis EXPIRE.
• After 3 hours, Redis deletes the to-do hash automatically.
• On list/update, expired IDs are removed from the todos list.

Live Chat Examples

Add a To-Do

User: Remind me to buy groceries later today.
Assistant: Added "buy groceries" to your to-do list.

List To-Dos

User: What do I need to get done?
Assistant:
Here are your current to-dos:
• Buy groceries [ ]

Mark a To-Do as Completed

User: I finished buying groceries. Mark that as done.
Assistant: Marked "buy groceries" as completed.

Delete a To-Do

User: Remove "buy groceries" from my list.
Assistant: Deleted "buy groceries" from your to-dos.

Delete All To-Dos

User: Clear my entire to-do list.
Assistant: All to-dos have been deleted.

Usage

Interact with the To-Do Manager via any MCP-compatible client or with HTTP requests.

Add a To-Do

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "To-Do Manager", "arguments": {"action": "add", "text": "Buy groceries"}}}'

List To-Dos

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "To-Do Manager", "arguments": {"action": "list"}}}'

Update a To-Do

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "To-Do Manager", "arguments": {"action": "update", "todoId": "YOUR_TODO_ID", "completed": true}}}'

Delete All To-Dos

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 4, "method": "tools/call", "params": {"name": "To-Do Manager", "arguments": {"action": "delete"}}}'

Technologies Used

• TypeScript
• Next.js
• Redis
• @vercel/mcp-adapter
• Zod
• Vercel

Contributing

1. Fork the repository
2. Create a new branch (git checkout -b feature/your-feature)
3. Make your changes and commit them
4. Push to your fork and open a Pull Request

Contact

• GitHub Issues: Open an issue
• Email: patelvasu1997@gmail.com
• Maintainer: Vasu Patel

This project is open source—use it as a reference or as a starting point for your own MCP development.