todoms-mcp

What is todoms-mcp?

todoms-mcp is a Model Context Protocol (MCP) server that bridges AI development tools with the "todoms" todo management application. It provides user authentication and todo item operations (create, read, update, delete) for AI assistants.

How to use todoms-mcp?

Clone the repository, install dependencies (npm install), build the project (npm run build), and start the server (npm start). The server communicates via stdin/stdout and requires a running todoms API server at http://localhost:8080.

Key features of todoms-mcp

• User sign-up, login, logout, and current user info retrieval
• Retrieve all todos or a specific todo by ID
• Create one or multiple todos at once
• Update an existing todo
• Delete a todo by ID

Use cases of todoms-mcp

• AI coding assistants managing personal or project todos
• Automated creation of tasks from natural language commands
• Querying and updating todo lists via chat interfaces

FAQ from todoms-mcp

What tools does todoms-mcp provide?

It exposes eight MCP tools: signup, login, logout, get_all_todos, get_todo, create_todos, update_todo, and delete_todo.

What are the prerequisites to run todoms-mcp?

Node.js (v14 or higher), npm or yarn, and a running instance of the todoms API server (default: http://localhost:8080).

How can I change the API server URL?

The API base URL is defined as API_BASE_URL in src/lib/api-client.ts. Edit that constant to point to your desired server.

What technology stack does todoms-mcp use?

TypeScript, Node.js, the MCP SDK, Zod for data validation, and the Fetch API for HTTP requests.

What license does todoms-mcp use?

It is distributed under the ISC license.