Margins — Claude on your Obsidian vault

Get started

Pick the row that matches your setup. You can change later.

I have a vault already

Obsidian, or a folder of Markdown. You know the path.

I'm starting fresh

No vault yet. Margins will scaffold one in your browser.

You have a vault

Easiest: download for Claude Desktop

Double-click to install. Pre-bundled with everything Margins needs. Claude Desktop will show the Margins logo in your Connectors list.

Download .mcpb (latest)

Open the file with Claude Desktop, point it at your vault path when prompted, restart Claude (Cmd-Q + reopen).

Or, via CLI (Claude Code users + terminal lovers)

npm install -g margins-mcp

Then find your vault path in Obsidian (right-click vault → Reveal in Finder) and run:

margins-mcp install --vault /absolute/path/to/your/vault

The installer writes the configs for Claude Desktop and Claude Code, scaffolds raw/ + proposed/ + .margins/ in your vault, and runs a verification probe.

Try it

Open a new Claude conversation:

Use margins to give me a summary of my recent notes.

Updates

Margins surfaces an update hint in margins_start when a newer version is available. CLI install: run margins-mcp install --update. Desktop install: re-download the .mcpb above and double-click.

You're starting fresh

Margins scaffolds the vault in your browser. Pick a parent folder; Margins creates a Margins/ directory inside with the right structure.

1. Scaffold the vault

Open a terminal and run:

npm install -g margins-mcp
margins-mcp install

The installer auto-detects ~/Margins/ and connects it to Claude Desktop / Claude Code. Restart Claude Desktop when it finishes.

3. Try it