todomate-mcp
Provides tools for managing Firestore todos, including listing, retrieving, creating, updating, completing, and deleting todo items in a Firebase project.
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., "@todomate-mcp list my todos for today"
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.
todomate-mcp
TodoMate의 Firestore Todo를 조회·생성·수정·완료·삭제하는 Python MCP 서버입니다.
개발 환경
Python 3.12 이상, uv
Official MCP Python SDK (
mcp), httpx, pydantic개발 의존성: pytest
Related MCP server: Firestore Todo List MCP Server
설치
uv sync소스 코드는 src/, 테스트는 tests/에 작성합니다.
.env.example을 복사해 로컬 .env를 만들고 인증값을 설정합니다. .env는 Git에서 제외됩니다.
테스트
uv run pytestFirebase 인증 테스트는 HTTP 응답을 mock으로 제공하므로 실제 계정이나 외부 API 접속이 필요하지 않습니다.
MCP server
로컬 stdio 서버는 다음 명령으로 실행합니다.
uv run todomate-mcpStreamable HTTP 서버는 /mcp에서 실행합니다. 개인 Todo에 접근하므로 HTTP 실행에는 별도의 Bearer 토큰이 필요합니다.
# 로컬 개발
TODOMATE_MCP_ACCESS_TOKEN="$(openssl rand -hex 32)" uv run todomate-mcp http --host 127.0.0.1 --port 8000
# MCP client: http://127.0.0.1:8000/mcp
# Authorization: Bearer <TODOMATE_MCP_ACCESS_TOKEN>TODOMATE_MCP_HOST, TODOMATE_MCP_PORT으로 기본 host와 port를 정할 수 있습니다. 공개 배포에서는 TLS를 종료하는 reverse proxy 뒤에서 실행하고, 외부 HTTPS 주소를 TODOMATE_MCP_PUBLIC_URL(예: https://todos.example.com/mcp)에 설정하세요. 현재 인증은 단일 개인용 Bearer 토큰 방식이며, 토큰 없이 /mcp에 요청하면 401을 반환합니다.
list_todos, get_todo, create_todo, update_todo, complete_todo, delete_todo를 지원합니다. 날짜를 생략하면 Asia/Seoul의 오늘을 사용합니다.
.env에는 TODOMATE_FIREBASE_API_KEY를 설정합니다. 계정 로그인은 아래 명령으로 수행하며, refresh token과 UID는 OS Keyring/Credential Manager에 저장됩니다. stdio MCP는 이 저장 credential로 Firebase 세션을 복원합니다.
대화형 로그인과 로컬 인증 상태 관리는 다음 명령을 사용합니다.
uv run todomate-mcp auth login
uv run todomate-mcp auth status
uv run todomate-mcp auth logout배포
원격 MCP 배포에 필요한 HTTPS, 시크릿, refresh token 영속화 및 운영 절차는 배포 가이드를 참고하세요.
Available Tools
6 toolscomplete_todoC
Mark one authenticated user's todo complete or incomplete.
Inputs: todo_id (required), completed.
create_todoB
Create a todo for the authenticated user. Date defaults to today in Asia/Seoul.
Inputs: content (required), day, goal_id.
delete_todoA
Delete one authenticated user's todo by ID.
Inputs: todo_id (required).
get_todoA
Get one of the authenticated user's todos by ID.
Inputs: todo_id (required).
list_todosA
List the authenticated user's todos for a date. Defaults to today in Asia/Seoul.
Inputs: day.
update_todoC
Update provided fields of one authenticated user's todo.
Inputs: todo_id (required), day, content, goal_id.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct action on the todo resource: list, get, create, update, complete, and delete. There is no meaningful overlap because complete_todo is explicitly for toggling completion status, separate from general field updates.
All tool names follow a clear verb_noun pattern (list_todos, get_todo, create_todo, update_todo, complete_todo, delete_todo). The only plural is list_todos, which is natural for listing multiple items, so the naming is highly predictable.
Six tools is an ideal size for a todo-focused server. Each tool covers a necessary operation without redundancy, and the set is small enough for an agent to navigate easily.
The tool surface provides full CRUD coverage plus dedicated completion handling. For the domain of personal todos, there are no obvious missing operations that would leave an agent unable to perform a normal workflow.
Maintenance
Related MCP Connectors
Create, list, and complete todo items through MCP.
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
Tasks, notes, and tags in TodoNote, with OAuth-scoped read and write access.
Toggl 2.0 MCP server for tasks, projects, time entries, and workspace operations.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP Server to create and manage tasks, projects, labels and more in Todoist, using their unified v1 API729 npm7GPL 3.0
- AlicenseAqualityDmaintenanceEnables AI assistants to manage todo lists through natural language by creating, listing, updating, completing, and deleting tasks stored in Firebase Firestore. Supports custom system prompts for personalized task management workflows.535 npmISC
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Todoist through the MCP interface, providing full CRUD operations for tasks and projects including creating, updating, completing, and filtering tasks with natural language commands.15 npmMIT
- AlicenseAqualityDmaintenanceA clean, reliable MCP (Model Context Protocol) server for Todoist — built on the Todoist unified API v1.201MIT