Bundled Notes MCP

Este servidor local expõe bundles, notas Markdown, tags/tarefas, quadros Kanban, templates personalizados, busca e Files & Photos pelo mesmo modelo Firebase usado pelo aplicativo web.

Contrato de segurança

• Toda ferramenta que altera estado retorna confirmation_required sem chamar a API, a menos que receba confirm=true.

• Arquivamento e restauração são explícitos. Exclusões permanentes têm nomes claros e removem recursivamente as subcoleções Firestore conhecidas.

• Atualizações usam update masks e preservam campos desconhecidos.

• Tokens de autenticação, compra e download nunca são retornados pelas ferramentas.

• Movimentações criam e verificam o destino antes de remover a origem, com rollback compensatório da cópia quando necessário.

• Exclusões de tag bloqueiam referências pendentes por padrão.

• Uploads respeitam o limite observado de 400 MiB e compensam falhas parciais.

Consulte WRITES.md antes de habilitar mutações.

Related MCP server: Apple Notes MCP

Início rápido

Requer Python 3.11+ e uv.

uv sync --extra dev

O bootstrap descobre a configuração pública atual do site e obtém um refresh token sem imprimir a senha ou o token:

uv run bundled-notes-bootstrap-auth --output .env

O helper solicita e-mail e senha interativamente. O .env é ignorado pelo Git e deve ser tratado como uma senha. Se a descoberta automática deixar de funcionar, informe a chave pública atual com --api-key.

Executar

Prefect Horizon (hospedado)

O deployment oficial deste repositório está disponível em:

https://bundled-notes-mcp.fastmcp.app/mcp

O endpoint exige autenticação do Horizon e promove automaticamente builds bem- sucedidos da branch main. No Horizon, use o entrypoint src/bundled_notes_mcp/server.py:mcp, pyproject.toml como arquivo de dependências e configure as variáveis Firebase como secrets. Os payloads MCP de requisição e resposta devem permanecer desabilitados nos logs porque podem conter notas e metadados privados.

Local (stdio)

uv run bundled-notes-mcp

Exemplo de configuração no Codex; em ambientes compartilhados, use um gerenciador de secrets:

[mcp_servers.bundled-notes]
command = "uv"
args = ["--directory", "C:/Users/guipm/Desktop/MCPs/bundled-notes-mcp", "run", "bundled-notes-mcp"]

[mcp_servers.bundled-notes.env]
BUNDLED_FIREBASE_API_KEY = "..."
BUNDLED_FIREBASE_REFRESH_TOKEN = "..."
BUNDLED_FIREBASE_UID = "..."

Comece com bundled_status e bundled_list_bundles. Para uma escrita, chame uma vez sem confirmação, revise IDs e payload, depois repita com confirm=true.

Ferramentas

A busca filtra notas localmente porque o aplicativo também usa um índice/cache no cliente, não um endpoint Firestore de texto completo. Os limites são finitos por padrão; aumente-os deliberadamente em contas grandes.

Desenvolvimento

uv run ruff check .
uv run pytest
uv build

Consulte engenharia reversa, modelo de dados e testes. llms.txt contém o mapa compacto para agentes.

Limites conhecidos

• Endpoints Firebase e caminhos Firestore são detalhes de implementação, não uma promessa de compatibilidade.

• Importação do Google Keep, exportação JSON, lembretes e geração derivada de rich links foram observados, mas não são ferramentas de mutação na versão 0.1.0.

• Antes de excluir um arquivo da conta, desanexe-o das notas relevantes.

• Contadores do documento de usuário podem atrasar; as listagens são a fonte operacional deste servidor.