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

Related MCP server: db4app Todo MCP Server

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"