Turn on Use Raven with AI.
It's in Settings on Mac. Start with Read only, and allow changes only for clients you trust.
Every note is a plain .md file. Raven's Companion gives Claude, Codex, and Cursor access you control.
US$19.99 once, no subscription. Apple handles refunds.
What's still open this week? Add it to today's journal.
Three to-dos are still open: book the Kyoto hotel, hang the hall shelf, and replace the bathroom bulb.
+ ## Still open + - [ ] Book the Kyoto hotel + - [ ] Hang hall shelf + - [ ] Replace bathroom bulb
Slow start, but it's a simple day.
connect
Raven isn't the assistant. It keeps the notes; your tools do the thinking.
It's in Settings on Mac. Start with Read only, and allow changes only for clients you trust.
Ready-made config for Claude and Cursor (JSON), Codex (TOML), and other local clients.
Companion shows what a client can read and change, and whether sync is up to date.
Agents can add to a note, or replace it if they have its latest version. Deleting, moving, and archiving aren't available to them.
companion
Reads and edits are separate settings. Destructive actions aren't exposed.
A bundled CLI and MCP server. Claude, Codex, Cursor, and local clients read the vault once you allow it.
Search and fetch, plus tools for notes, tasks, folders, and today's journal.
Writes go through Raven's sync layer, which checks a note hasn't changed before replacing it.
Finder, git, ripgrep, and editors still work, because the notes are Markdown files.
plain files
Files open in any editor, in grep and git, with no export step.
| Raven | Typical app-owned notes | |
|---|---|---|
| Storage | Plain .md files in your folder | Database, cloud document, or export format |
| Agent access | Companion MCP/CLI plus plain-file vault access | Requires export, API access, or a plugin |
| Assistant | Use Claude, Codex, Cursor, or your own local MCP client | Often tied to an in-app assistant |
| Portability | Open notes in any Markdown editor | Export first, then clean up |
| Privacy posture | Local-first; sync is optional | Cloud-first by default |
| Best for | Writers and developers on Mac, iPhone, and iPad | Teams, web workspaces, or app-specific assistant features |
questions
No. Raven is not a built-in chatbot. It keeps every note as Markdown and ships a local Companion CLI/MCP server so Claude, Codex, Cursor, and local agents can work with the vault you allow.
On Mac, open Raven Settings, then Use Raven with AI. Choose Read only or Read and change, then copy the setup for your client: MCP JSON for Claude and Cursor, TOML for Codex, or STDIO fields for local MCP clients.
Raven ships its own Companion CLI/MCP helper. Plain-file access still matters, but the first-party MCP route is better for Raven-aware note and task operations because it respects permissions, hashes, journal identity, and sync state.
No. Raven is local-first and does not include a model-training pipeline. If you choose to use Claude, Cursor, or another outside tool with your notes, that tool's own privacy policy applies.
Yes, when Read and change is selected. Common writes include creating notes, appending to notes, appending today's journal, renaming a note's first H1, replacing a body with a fresh body hash, and creating or completing tasks.
Native on Mac, iPhone, and iPad, saved as plain Markdown files you control.
Download Raven