todo

This MCP server provides a lightweight API for managing a SQLite-backed list of todo items. It exposes three primary tools via the MCP interface: add-todo to create a new item, get-todos to list all items, and remove-todo to delete an item by its ID. The server is implemented in TypeScript with better-sqlite3 for database access and uses the MCP SDK to expose a consistent, model-context protocol compatible API. After starting the server, clients can invoke the tools with appropriate parameters to manage their todo collection. For example, add-todo can be called with a text payload to create a new item, get-todos returns the full list, and remove-todo deletes a specified item by ID.

Prerequisites:

• Node.js (>= 14.x) and npm
• Basic Git workflow

Steps:

1. Clone the repository: git clone https://github.com/your-org/leonvanzyl-todo-mcp-server.git

2. Navigate to the project: cd leonvanzyl-todo-mcp-server

3. Install dependencies: npm install

4. Configure database location (optional):

   • Open src/database.ts
   • Modify the DB_LOCATION variable to your desired path, for 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";

5. Build the project: npm run build

6. Start the server: node dist/index.js (Or use your normal startup script if provided by the project.)

Notes:

• The database is SQLite-based and will be created automatically if missing. By default, the database file is located at C:/todos/todos.db unless you change DB_LOCATION in src/database.ts.
• On Windows, ensure the directory you specify has proper write permissions. On Unix-like systems, ensure the process has permission to write to the chosen path.
• The server uses MCP SDK conventions for tools. You can extend it with additional MCP tools following the same pattern as add-todo/get-todos/remove-todo.
• If you encounter port or binding issues, verify any environment variables or startup scripts used by your deployment environment.