Firestore Todo List MCP Server
Stores and manages todo list data using Firebase Firestore, providing persistent storage for tasks with operations like create, list, update, complete, and delete todos.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Firestore Todo List MCP Server add 'buy groceries' to my todo list for tomorrow"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Firestore Todo List MCP Server
Connect any MCP Client like Claude, Open-WebUI and others to this MCP server to manage todos via AI chat in an opinionated way.
You can simply tell the model to create_todo, list_todos, update_todo, 'complete_todo' and delete_todo
You can setup a custom system prompt as well to get customized answers.
Works very well with Claude, OpenAI and Deepseek models (paid versions). Local models in Ollama also works, but with limitations.
Data is stored on Firebase Firestore because it is "free" for personal usage, easy to run, and easy to setup.
This is an experimental project I created just for learning purposes.
Feel free to try.
Getting Started
Use the Firestore Todo MCP Server on Claude (and others)
Edit the claude_desktop_config.json or the mcp configuration file of your LLM client
{
"mcpServers": {
"firestoreTodoMcp": {
"command": "npx",
"args": [
"firestore-todo-mcp"
],
"env": {
"FIREBASE_SERVICE_ACCOUNT": "base64(serviceAccount.json)",
"FIREBASE_PROJECT_ID": "your-firebase-project-id",
"FIRESTORE_COLLECTION": "test_collection"
},
"type": "stdio"
}
}
}Don't forget to setup your project on Firebase and to get the Firebase serviceAccount from the project's configuration.
The file content must be 'base64' encoded when passing the value to the json above.
Related MCP server: Todoist MCP Server
Development Mode
1. Clone the repo
git clone https://github.com/gtoshinakano/firebase-todo-mcp.git
cd firebase-todo-mcp2.Run Firestore emulator
Install firebase-tools cli, do firebase login, install emulators and run
firebase emulators:start --only firestore --project local-todo-dev3.Testing on Inspector
Check if all tools are working fine, test input parameters, output params
npx @modelcontextprotocol/inspector \
-e FIRESTORE_EMULATOR_HOST=localhost:3333 \
-e FIREBASE_PROJECT_ID=local-todo-dev \
-e FIRESTORE_COLLECTION=test_collection \
tsx bin/index.ts4. (Optional) Build and Configure Claude mcp configuration locally
{
"mcpServers": {
"firestore-todo": {
"command": "node",
"args": ["/absolute/path/to/dist/bin/index.js"],
"env": {
"FIRESTORE_EMULATOR_HOST": "localhost:3333",
"FIREBASE_PROJECT_ID": "local-todo-dev",
"FIRESTORE_COLLECTION": "test_collection"
}
}
}
}5. Create a project with a system prompt from the example
Copy the contents of the system prompts from the path example/
complete: More effective, but token expensive
short: Shorter version for saving tokens. Works fine but less accurate
6. Have fun with your new Task Manager ;)
Try chat like:
Add the task XYZ. Due date tomorrow.
You can be more specific and tell the situation:
I forgot to talk to John regarding XYZ on Friday and I need this ASAP
Or you can be broad and Claude will try to help you split the big task into smaller ones (doesn't work well with Ollama models :/):
I need to create my XYZ Vague Project
Available Tools
5 toolscomplete_todoComplete todo/taskB
Mark an existing todo item as completed.
Inputs: id (required), archive, completionNotes. Returns: todo
create_todoCreate todo/taskB
Add a new todo/task item to the user's store
Inputs: title (required), role (required), details, completed, +2 more. Returns: todo
delete_todoDelete todo/taskA
Delete a todo item from the user's Firestore 'todos' collection by id.
Inputs: id (required). Returns: deletedId
list_todosList todos/tasksB
List todo items from the user's 'todos' store with optional filters.
Inputs: completed, archived, from, to, +2 more. Returns: todos
update_todoUpdate todo/taskC
Update fields of an existing todo item (text, completed, dueDate, role).
Inputs: id (required), title, details, completed, +5 more. Returns: todo
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose targeting specific CRUD operations on todo items: create, list, update, delete, and complete. No overlap exists between tools, making it easy for an agent to select the correct one based on the intended action.
All tool names follow a consistent verb_noun pattern with 'todo' as the noun (e.g., create_todo, list_todos). The naming is uniform, using snake_case throughout, which enhances readability and predictability for agents.
With 5 tools, this server is well-scoped for a todo list domain, covering essential operations without bloat. Each tool earns its place by providing core functionality, making the set efficient and manageable for typical use cases.
The toolset offers complete CRUD coverage for todo items, including create, read (list), update, delete, and a specialized complete action. There are no obvious gaps; agents can perform all necessary lifecycle operations without dead ends.
Maintenance
Related MCP Connectors
AI-powered to-do list: add, list, complete and organise tasks across lists from any assistant.
Manage tasks, Focus Zone, notes, projects, and task history from compatible AI assistants.
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.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Todoist tasks, projects, labels, sections, and comments through natural conversation. Supports comprehensive task operations including creation, updates, completion, and organization with natural language quick-add functionality.-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Todoist tasks, projects, sections, and labels through natural language, supporting task creation, updates, completion, and intelligent organization of your workflow.17 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Todoist tasks, projects, comments, and labels through natural language commands. Provides complete CRUD operations securely via the Todoist REST API v2.Apache 2.0
- AlicenseNot gradedqualityFmaintenanceEnables AI assistants to manage Todoist tasks, projects, sections, labels, and comments through natural language conversations, providing complete control over your productivity workflow via the Todoist API.7MIT