todo-mcp-server

todo-mcp-server

0
os_automation

The Todo MCP Server is designed to allow AI agents to manage todos using the Model Context Protocol. It enables operations such as retrieving, creating, updating, and deleting todos in a standardized manner through a REST API.

Todo MCP Server

This repository provides an MCP (Model Context Protocol) server for interacting with the Todo App through Claude and other MCP-compatible AI tools. This project allows AI agents to access and manage todos using the standardized MCP interface.

MCP SERVER

Overview

The MCP server uses the Python SDK to expose a REST API (built with Next.js, hosted on Netlify) to MCP-compatible clients. It acts as a lightweight protocol server to retrieve, create, update, and delete todos.

Powered by:

  • Python SDK for MCP
  • Next.js API routes
  • Prisma ORM + PostgreSQL
  • JWT-based auth

Features

  • Exposes Todo API operations as MCP tools
  • Retrieves todos via @mcp.resource
  • Supports create, update, delete, and mark-as-complete
  • Works with Claude’s chat UI for seamless interaction

Installation & Usage

1. Clone the Repository

git clone https://github.com/Adhishtanaka/todo-mcp-server.git
cd todo-mcp-server

2. Install Python Dependencies

pip install -r requirements.txt

3. Create a .env File

Create a .env file and add your JWT TOKEN:

TOKEN=your_jwt_token_here

4. Run the MCP Server

mcp install server.py

Notes

  • This server is built for educational and integration purposes
  • Add rate limiting, logging, and error handling for production use
  • Secure token handling is essential in deployment

License

This project is licensed under the .

Author

  • Adhishtanaka Thiramithu Kulasooriya
  • GitHub: @Adhishtanaka
  • Email: