memcal

Memory + Calendar for AI agents

Most memory systems for agents like OpenClaw or Hermes (Mem0, Hindsight) are good at saving things like preferences and observations, but fail at personal assistant tasks, like remembering you have a dentist appointment next Friday. Memcal attempts to bridge this gap by enabling an agent to maintain its own internal calendar of your life. On top of that, a nightly fact-gathering stage will scan sources like iMessage, email, WhatsApp, iCal, and more to automatically update the agent calendar.

With Memcal, you can ask an agent, “What’s my weekend looking like?” and it will remember that your friend is free for dinner Saturday night, that the nonprofit you follow is having a member day, or even that your family is coming into town...

Instant answers: Memcal pre-renders a brief of your week into the prompt, so Hermes can answer without firing off a long, expensive lookup first.

Under the hood

• Write-time recency — updates move old values to history; read time isn’t a relevance fight (memcal vs retrieval)
• Pre-rendered brief — the week is already in the prompt, so weekend / “is that still on?” questions answer right away without a slow tool round-trip
• Typed stores — events, series, todos, questions, wiki
• Multi-stream join — Slack, Messages, email, calendar, and agent chat resolve to one underlying thing
• Nightly dream pass — observe → gate → propose → merge → brief

Install

Requires Python 3.11+, SQLite with FTS5, and one model backend (Codex by default; Claude Code, Antigravity, or OpenRouter also work).

Quick start

pip install memcal
memcal setup
memcal doctor
memcal brief

Memcal is built first for macOS — Messages, Calendar (EventKit), and launchd scheduling are the full product path. Connect those, then ask the agent what your week looks like.

Slack (pip install 'memcal[slack]') and MCP work on any machine if you want chat without the Apple sources.

From source (alternate):

git clone https://github.com/cuuush/memcal.git
cd memcal
./install.sh

Memcal reads sensitive personal data and sends selected source text to the model provider you configure — read the privacy notes before connecting real accounts.

MCP (any harness)

python3 -m memcal.mcp_server

Native plugins: Hermes · OpenClaw

Learn more

Full guides: https://cuuush.github.io/memcal/

• Quickstart — install, first ingest, nightly job
• Sources — Slack, Telegram, WhatsApp, iMessage, Signal, email, calendar, …
• CLI · MCP · Integrations
• Evaluation — how memory quality is measured

Contributing: CONTRIBUTING.md. Notable changes: CHANGELOG.md.