Notes for AI agents

Local notes agents can trust. Plain files on disk. MCP to attach. Versioned Save for the trail. No second cloud brain.

The claim

Agents need trusted context — decisions, research, project fragments only you have. That context should live as ordinary markdown the human already owns, not as memory locked inside one chat product.

• Humans capture and think in a calm Mac app.
• Agents (Grok Build, Cursor, Claude, others) attach to the same folder via MCP.
• Neither requires uploading the vault to stay useful.

Three concrete scenarios

1. Grok Build on a live decision

You keep a decisions.md and a few research captures in the Locker. In Grok Build you attach Markdown Locker MCP, then ask: “What did we decide about pricing, and what evidence is in the Locker?” The agent calls search_notes / read_note over your folder — it does not need a pasted vault or a cloud sync of your life. Setup: Connect Grok Build.

2. Cursor (or any MCP client) on a product thread

A long-running product note sits next to change logs and meeting captures. The agent lists recent notes, opens the brief, and drafts against your wording — same path Capture and Workspace already use. Attach. Don’t upload.

3. Versioned Save as an evolution trail

When you overwrite a note, Markdown Locker archives the previous body under versions// and stamps the live file with updated, version, and previous. Agents that re-read the live note see when it changed and where the prior text went — without inventing history. Humans get the same trail in Finder. More in Versioned Save on Word.

On disk

Default: ~/Documents/Markdown Locker (legacy installs may use ~/Markdown Locker). Live notes are top-level .md files. Archives sit under versions// with frontmatter on the live file. See Local-first for why the folder stays ordinary.

Connect now

Native MCP v0 (read-only): search_notes, read_note, list_recent. Setup: Connect Grok Build. Copy commands also live in the app under Think → AI settings → Agents · MCP.

grok.com Custom MCP needs a public URL — different path; local Build is the default for private notes.

How agents find the product

1. Narrative — this page, Word, X: local notes for the AI era.
2. Discovery — /llms.txt.
3. Use — MCP scoped to the Locker; skill pack in the repo under skills/markdown-locker/.

Privacy

• Files stay on the machine unless the user connects a tool that reads them.
• Think / Workspace use the user’s API key; we do not host notes.
• Native MCP is read-only and path-scoped.