Skip to main content
Glama

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 pytest

Firebase 인증 테스트는 HTTP 응답을 mock으로 제공하므로 실제 계정이나 외부 API 접속이 필요하지 않습니다.

MCP server

로컬 stdio 서버는 다음 명령으로 실행합니다.

uv run todomate-mcp

Streamable 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 tools
complete_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

    A3.7/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers