Todo MCP Server

🚀 To-Do MCP Server

A simple MCP (Model Context Protocol) server for managing to-do items, using an SQLite database for storage.

🚀 Quick Start

✨ Features

• Add new to-do items.
• List all to-do items.
• Delete a to-do item by ID.

📦 Installation

1. Install dependencies:

npm install

2. Configure the database location (optional): Open the src/database.ts file and modify the DB_LOCATION variable to your preferred location:

// Example:
// - Windows: "C:/todos"
// - macOS: join(homedir(), "todos")
// - Linux: "/home/username/todos" or join(homedir(), "todos")
// - Current directory: join(process.cwd(), "data")
const DB_LOCATION = "C:/todos";

3. Build the project:

npm run build

🔧 Technical Details

Database

This application uses SQLite for data storage. By default, the database file is located at C:/todos/todos.db. You can change this location by modifying the DB_LOCATION variable in the src/database.ts file. If the specified directory and database file do not exist, they will be created automatically.

💻 Usage Examples

Available Tools

add-todo

Add a new to-do item to the list. Parameters:

• text (string): The text content of the to-do item. Example:

add-todo(text: "Buy groceries")

get-todos

List all to-do items. Example:

get-todos()

remove-todo

Delete a to-do item by ID. Parameters:

• id (number): The ID of the to-do item to be deleted. Example:

remove-todo(id: 1)

📚 Documentation

Development

This project is built using the following technologies:

• TypeScript
• better-sqlite3 for database operations
• MCP SDK to implement the server