Notes your AI can read.

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.

connect

Four steps on your Mac.

Raven isn't the assistant. It keeps the notes; your tools do the thinking.

1

Turn on Use Raven with AI.

It's in Settings on Mac. Start with Read only, and allow changes only for clients you trust.

2

Copy the setup.

Ready-made config for Claude and Cursor (JSON), Codex (TOML), and other local clients.

3

Test the connection.

Companion shows what a client can read and change, and whether sync is up to date.

4

Let it work.

Agents can add to a note, or replace it if they have its latest version. Deleting, moving, and archiving aren't available to them.

Read the guide to giving Claude your notes

companion

What agents can do.

Reads and edits are separate settings. Destructive actions aren't exposed.

Connect the Raven vault.

A bundled CLI and MCP server. Claude, Codex, Cursor, and local clients read the vault once you allow it.

Search with Raven tools.

Search and fetch, plus tools for notes, tasks, folders, and today's journal.

Write only when you allow it.

Writes go through Raven's sync layer, which checks a note hasn't changed before replacing it.

Keep the files useful outside Raven.

Finder, git, ripgrep, and editors still work, because the notes are Markdown files.

plain files

Locked-in notes block the assistant.

Files open in any editor, in grep and git, with no export step.

RavenTypical app-owned notes
StoragePlain .md files in your folderDatabase, cloud document, or export format
Agent accessCompanion MCP/CLI plus plain-file vault accessRequires export, API access, or a plugin
AssistantUse Claude, Codex, Cursor, or your own local MCP clientOften tied to an in-app assistant
PortabilityOpen notes in any Markdown editorExport first, then clean up
Privacy postureLocal-first; sync is optionalCloud-first by default
Best forWriters and developers on Mac, iPhone, and iPadTeams, web workspaces, or app-specific assistant features

questions

Straight answers.

Does Raven include an assistant?

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.

How does Raven work with Claude, Codex, and Cursor?

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.

Does Raven require an MCP plugin?

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.

Does Raven train a model on my notes?

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.

Can local agents write notes back into Raven?

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.

Beautiful notes. Never locked in.

Native on Mac, iPhone, and iPad, saved as plain Markdown files you control.

Download Raven