TodoSQLite MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
TodoSQLite MCP Server 🗂️
Quản lý todo list cá nhân với lưu trữ SQLite local - hỗ trợ CRUD đầy đủ, search theo từ khóa, stateful và persistent. Lý tưởng cho AI agent productivity tool (giống Todoist mini hoặc Linear task manager).
Built with Node.js + TypeScript + FastMCP + better-sqlite3 + Zod — designed to demonstrate senior-level MCP tooling skills.
📦 Installation
# 1. Clone / navigate to project
cd /path/to/MyMCPServer
# 2. Install dependencies
npm install
# 3. (Optional) Build to JS
npm run buildDatabase: Automatically created at
~/.todo_mcp.dbon first run. No setup needed.
Related MCP server: Todo MCP Server
🚀 Running the Server
Development (ts-node, recommended for local use)
npm run devProduction (compiled JS)
npm run build && npm startType-check only
npm run typecheck🛠️ Available Tools
Tool | Description | Key Params |
| Add a new task |
|
| List all todos with | — |
| Toggle completed/pending by ID |
|
| Permanently delete a task by ID |
|
| Case-insensitive LIKE search |
|
🗄️ Database Schema
CREATE TABLE todos (
id INTEGER PRIMARY KEY AUTOINCREMENT,
task TEXT NOT NULL,
completed INTEGER NOT NULL DEFAULT 0, -- 0=pending, 1=done
created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
due_date TEXT -- ISO date e.g. "2026-03-01"
);DB file location: ~/.todo_mcp.db (configurable via TODO_DB_PATH env var)
🔌 Connecting to Antigravity (Claude Desktop / MCP Client)
Add this entry to your mcp_config.json:
{
"mcpServers": {
"todo-sqlite": {
"command": "npx",
"args": [
"ts-node",
"--esm",
"/absolute/path/to/MyMCPServer/src/index.ts"
],
"env": {}
}
}
}Or if using compiled JS:
{
"mcpServers": {
"todo-sqlite": {
"command": "node",
"args": ["/absolute/path/to/MyMCPServer/dist/index.js"],
"env": {}
}
}
}💬 Demo Prompts for Antigravity
# Add a task due tomorrow
@todo-sqlite Thêm task "Hoàn thành MCP server cho interview" due tomorrow
# List all todos
@todo-sqlite Liệt kê tất cả todos của tôi
# Search for a keyword
@todo-sqlite Tìm kiếm task liên quan đến "interview"
# Toggle task #1 as done
@todo-sqlite Đánh dấu task #1 là hoàn thành
# Delete task #3
@todo-sqlite Xóa task #3
# Workflow: add multiple, then list
Add these tasks:
- "Review PR #42" due today
- "Update README" due 2026-03-05
- "Write unit tests" due tomorrow
Then list all todos.🏗️ Project Structure
MyMCPServer/
├── src/
│ ├── index.ts # FastMCP server — 5 tools, Zod schemas, error handling
│ └── db.ts # SQLite layer — prepared statements, typed CRUD functions
├── dist/ # Compiled output (after npm run build)
├── .env.example # Environment variable reference
├── package.json
├── tsconfig.json
└── README.md🧠 Architecture Highlights (for Interview Discussion)
Concern | Approach |
SQL Injection | 100% prepared statements via |
Type safety | Full TypeScript strict mode + |
Validation | Zod schemas with |
Modularity | DB logic isolated in |
Error handling | Each tool wrapped in try/catch → friendly string messages |
Persistence | SQLite WAL mode, singleton DB connection |
Natural language dates |
|
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
AI-powered to-do list: add, list, complete and organise tasks across lists from any assistant.
AI-native task management: list, create, update and archive tasks with rich context for AI agents
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Simple to-do lists for students and teams: list, search, add, update and complete tasks.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables Claude to manage todo lists with full CRUD operations including creating, listing, toggling completion status, deleting, and searching todos. Uses SQLite database with Prisma ORM for reliable data persistence and includes optional due date functionality.1-
- AlicenseAqualityDmaintenanceEnables AI assistants to manage a todo list with add, list, complete, and delete tasks.410 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage a todo list with full CRUD operations, including creating, reading, updating, and deleting todos via a FastAPI backend with SQLite persistence.-
- AlicenseNot gradedqualityDmaintenanceEnables to manage to-do items through natural language, with tools for creating, reading, updating, and deleting tasks.ISC