convez.ai
MCP ServerProdutividadeIntermediário
pyranthus-hq

Mora – Memória Local para Agentes MCP

pyranthus-hq/mora

Memória local, zero-egresso, para agentes que precisam de contexto pessoal

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que indexa Gmail, Google Calendar, iMessage, Apple Calendar e arquivos locais em um cofre SQLite criptografado na sua máquina, sem egresso de dados. Agentes MCP (Claude Code, Codex) consultam a memória pessoal com busca híbrida, ranking de relevância e citações automáticas.

Instalação

$npx convez-ai pyranthus-hq/mora

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
12
Forks
0
Acompanhando
1
Saúde
50%
Último commit
há 1 dia
Versão
v0.17.0
Issues abertas
58
Contribuidores
1

Casos de uso

  • Agentes acessarem histórico de emails e calendários sem expor dados à nuvem
  • Busca contextual em conversas pessoais com citações automáticas
  • Síntese diária inteligente (brief) a partir de múltiplas fontes
  • Multi-agente acessando o mesmo cofre de memória compartilhada

Veredito

Mora é uma solução sofisticada para quem precisa de memória contextual em agentes, com ênfase em privacidade local-first. A implementação em Go puro e suporte multi-plataforma são pontos fortes, mas requer setup manual (OAuth, permissões de sistema) e está em fase inicial de maturação.

README

A tradução para o português deste README ainda está na fila.

Mora

Local-first memory for MCP agents.

CI Release License Go Egress

Mora indexes your Gmail (one or several accounts), Google Calendar, iMessage, Apple Calendar, and local files into a vault of Markdown files and a SQLite index on your machine, then serves it over MCP (the Model Context Protocol) to Claude Code, Codex, or any other MCP client. Point several agents at the same vault and they all answer from your history, with citations.

It runs entirely on your machine: no server, no signup, no telemetry. iMessage and Apple Calendar need macOS; Gmail, Calendar, and files also run on Linux.

What it looks like

$ mora think "what did we decide with Sam about pricing?"

Evidence (3):
  [mem_20260610_204655_f3049131] Pricing call with Sam: agreed to $29 one-time
  for the pilot; revisit a subscription tier once we cross 10 seats. He wants the
  invoice before Friday.
  ...

Gaps: none detected.

think returns cited evidence plus the gaps it found: stale results, thin coverage, a name the vault has never seen. There's no API key and no model to host; your agent does the reasoning and calls search_memory, think, and brief over MCP.

Install

curl -fsSL https://raw.githubusercontent.com/pyranthus-hq/mora/main/install.sh | sh

The script installs the release binary for your platform, clears the macOS Gatekeeper quarantine (binaries are ad-hoc signed, not notarized), and runs mora init (your vault lives at ~/vault/mora). It does not verify checksums; they are on each release if you want to check by hand. Update in place later with mora upgrade (source builds report dev and cannot self-update). Prefer to build it yourself? go install github.com/pyranthus-hq/mora/cmd/mora@latest (Go 1.25+, pure Go, no CGO).

Then connect your sources:

mora connect google                    # OAuth login, then backfill Gmail + Calendar (read-only; ~90 days, --since-days to widen)
mora connect google --account work     # add a second mailbox (gmail-work / calendar-work sources)
mora connect imessage                  # macOS; walks you through Full Disk Access
mora schedule install ingest-hourly    # background sync (launchd; prints a cron line on Linux)

Wire Mora into your agents (registers the local MCP server):

claude mcp add mora -s user -- mora mcp serve    # Claude Code
codex  mcp add mora -- mora mcp serve            # Codex

Per-connector setup and options are in the guide.

Agent skills (optional)

A small plugin of agent-side recipes that pair with the MCP server; they teach an agent to resolve people, shared history, and calendar context from the vault before reaching for the web:

/plugin marketplace add pyranthus-hq/mora
/plugin install mora@mora

First skill: /mora:dining-concierge, for outing recommendations grounded in who's coming and where you've actually been. Skills are plain Markdown (plugins/mora); other agents can copy them into their own skills directory.

Why a local corpus

Mora keeps a persistent local corpus, so you can ask "what did I commit to, and to whom" across months and have the same context whichever assistant you use. It indexes iMessage (which has no cloud API) and handles several mail accounts at once, then serves all of it to whatever agent you use. Cloud connectors fetch from Google's APIs per query and keep nothing between calls.

MoraCloud connectorsMCP Gmail servers
Data livesYour disk (Markdown + SQLite)Vendor cloudNowhere (live fetch)
iMessageYes (local chat.db, read-only)NoNo
Multiple mailboxes in one viewYesNoPer server
One person across email + texts + calendarYesNoNo
Shared by every agent (Claude, Codex, etc.)YesTied to the vendorPer client
Works offline / greppableYesNoNo
Cost$0, no Mora accountSubscriptionFree

What you get

  • Plain files you own. Every email thread, text conversation, and calendar event is one Markdown file. Open them in Obsidian, grep them, or back them up like any folder. The SQLite index is disposable: delete it and mora index rebuild rebuilds it from the files.
  • Documents and PDFs. Point Mora at a folder and it indexes your notes, text files, Word documents, and text-based PDFs, including a PDF someone texts you. Add a files source.
  • One view of each person. mora graph "Sam" pulls someone together across email, texts, and calendar (including mail from different accounts) into shared threads, meetings, and the people they appear with, every line cited. Identity matching is deterministic: it merges the same mailbox written different ways (Gmail dot and +tag variants) and links different addresses only by a shared trusted name with a corroborating address. How the graph works.
  • Keyword and semantic search. Keyword search (BM25) is built in. Run mora config embedder ollama to add local semantic search through Ollama. How retrieval works.
  • A daily brief. mora brief shows new and updated threads, upcoming events, and stale open tasks, ranked by a per-person salience score. Filter it to one person with mora brief --entity "Riya", or build a cited prep pack for your next meeting with mora prep.
  • Off-device backup. mora sync git pushes the vault to any private git remote you control: GitHub, GitLab, self-hosted, or a bare repo on a USB stick. It pushes vault files only; your tokens and the index stay on your machine. Restore with git clone and mora index rebuild. Details.
  • Shared across agents. 12 MCP tools let any MCP client search memory, read the brief, prep for a meeting (meeting_prep), and write facts back (write_memory). mora mcp serve runs as a local stdio process, so several agents share the same vault. Every search result reports how fresh each source is. Wiring guide.

Privacy

  • Read-only at the source. Google scopes are gmail.readonly and calendar.readonly; iMessage and Apple Calendar are opened read-only. Mora never sends, changes, or deletes anything in your accounts. Its write_memory and delete_memory tools only touch the local vault.
  • Everything on your disk. The vault, index, and OAuth tokens (~/.config/mora/tokens/, mode 0600) live on your machine. There is no analytics endpoint. The only log is a local usage log (tool name, timing, result counts, scope, and your query text) that you can turn off with mora usage off or DO_NOT_TRACK=1.
  • Zero egress by default. No server, no hosting. Mora reaches the network only to sync your sources, fetch updates during mora upgrade, and push your opt-in git backup; the optional Ollama embedder is loopback-only. mora doctor warns if the vault is a git repo, and git-remote-gcrypt gives you an encrypted remote.

Docs

The guide covers connectors, MCP wiring, daily use, retrieval, and the cloud comparison. docs/architecture/ is the contributor spec: 13 subsystem docs with diagrams and file:line citations.


Ver o original no GitHub

Bom para

Relacionados