---
title: "AI-Friendly Markdown Notes for Claude & Cursor | Raven"
description: "Raven keeps notes as plain .md files and ships a permissioned Companion CLI/MCP server for Claude, Codex, Cursor, and local agents."
url: https://ravennotes.app/ai-friendly-notes-app/
language: en
---

# Notes your AI can read.

Every note is a plain .md file. Raven's Companion gives Claude, Codex, and Cursor access you control.

[Download Raven](https://apps.apple.com/app/apple-store/id6761693183?pt=112920810\&ct=web_ai_notes\&mt=8)

US$19.99 once, no subscription. Apple handles refunds.

*A chat with an AI assistant that has the Raven folder: asked what is still open this week, it reads today's journal and two notes, lists three open to-dos, and adds them to the journal file; the Raven journal page beside it shows the new to-dos*

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](https://ravennotes.app/blog/give-claude-access-to-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.

|                 | 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

## 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.

## Keep reading

[CLI, MCP, Claude & Codex](https://ravennotes.app/raven-automation)

[The exact setup, step by step.](https://ravennotes.app/raven-automation)

[Obsidian alternative](https://ravennotes.app/obsidian-alternative)

[A native, file-based vault for Apple devices.](https://ravennotes.app/obsidian-alternative)

[Plain-text, local-first notes](https://ravennotes.app/plain-text-notes-app)

[Your notes stay on your device, in your folder.](https://ravennotes.app/plain-text-notes-app)

## Beautiful notes. Never locked in.

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

[Download Raven](https://apps.apple.com/app/apple-store/id6761693183?pt=112920810\&ct=web_ai_notes\&mt=8)
