Todo List App with FastAPI and MCP Integration

A complete todo list application with a modern web interface, REST API built with FastAPI, and Model Context Protocol (MCP) integration for Gemini CLI.

Features

Backend API

• Create, read, update, and delete todos
• Mark todos as completed or pending
• Filter todos by completion status
• Automatic API documentation with Swagger UI
• RESTful API endpoints

Frontend Interface

• Modern, responsive web interface
• Interactive todo management
• Real-time statistics
• Filter todos by status (All, Pending, Completed)
• Edit and delete todos with confirmation
• Beautiful gradient design with animations
• Mobile-friendly responsive layout

MCP Integration

• Model Context Protocol (MCP) server for AI assistant integration
• Gemini CLI support - Control your todos through natural language
• FastMCP framework for seamless AI integration
• Complete tool set for todo management via AI
• Natural language interface for todo operations

Setup

Basic Setup

1. Activate the virtual environment:

   source venv/bin/activate
   

2. Install dependencies:

   pip install -r requirements.txt
   

3. Run the application:

   python main.py
   

   Or alternatively:

   uvicorn main:app --reload
   

MCP Integration Setup

For AI assistant integration with Gemini CLI:

1. Start both services (FastAPI app + MCP server):

   ./start_services.sh
   

2. Configure Gemini CLI by adding to your Gemini config:

   {
     "mcpServers": {
       "todo-mcp-server": {
         "command": "/path/to/your/project/venv/bin/python",
         "args": ["mcp_server.py"],
         "cwd": "/path/to/your/project"
       }
     }
   }
   

3. Test with Gemini CLI:

   • "Show me all my todos"
   • "Create a new todo called 'Learn FastAPI'"
   • "Mark todo as complete"
   • "What's my completion rate?"

See MCP_INTEGRATION_GUIDE.md for detailed setup instructions.

API Endpoints

• GET / - Welcome message
• GET /todos - Get all todos
• GET /todos/{todo_id} - Get a specific todo
• POST /todos - Create a new todo
• PUT /todos/{todo_id} - Update a todo
• DELETE /todos/{todo_id} - Delete a todo
• GET /todos/completed - Get completed todos
• GET /todos/pending - Get pending todos

Access the Application

Once the server is running, visit:

• Web Interface: http://localhost:8000 (Main todo list interface)
• API Documentation: http://localhost:8000/docs (Swagger UI)
• Alternative API Docs: http://localhost:8000/redoc

Example Usage

Create a new todo:

curl -X POST "http://localhost:8000/todos" \
     -H "Content-Type: application/json" \
     -d '{"title": "Learn FastAPI", "description": "Build a todo API", "completed": false}'

Get all todos:

curl -X GET "http://localhost:8000/todos"