Margins
Connect Claude Pro or Max to your local Obsidian vault so the agent reads markdown notes and proposes edits instead of copying text in and out.
Overview
Margins is a Build-phase MCP server that connects Claude Pro/Max to your Obsidian vault to read markdown and propose note writes.
What is this MCP server?
- Uses your existing Claude Pro/Max subscription—not a separate API billing path for vault work
- Reads markdown from your Obsidian vault via MCP
- Proposes writes so you stay in control of note changes
- stdio via margins-mcp npm package v0.15.3 with npx runtime hint
- Documented at marginsmcp.com with GitHub source Margins
- Server version 0.15.3
- npm identifier margins-mcp with npx runtime hint
- stdio-only transport in published server schema
Community signal: 1 GitHub stars.
What problem does it solve?
Copying vault markdown into chat wastes time and breaks links, so your agent cannot see the notes you already maintain in Obsidian.
Who is it for?
Obsidian-first solo builders on Claude Pro/Max who want vault-grounded planning, specs, and docs from Claude Code or Cursor.
Skip if: Teams standardized on Notion or Google Docs only, or anyone who needs unsupervised automatic file writes without review.
What do I get? / Deliverables
After registering Margins, your agent reads vault markdown in context and suggests edits you can apply without leaving your MCP client.
- Vault markdown readable in agent context via MCP
- Proposed write operations for note updates you approve
- Subscription-based vault workflow without per-token API setup for notes
Recommended MCP Servers
Journey fit
Documentation and personal knowledge bases are built alongside the product; Margins targets the build phase where Obsidian holds specs, research, and ship logs. Docs subphase covers markdown knowledge bases; read-and-propose-write on vault files is direct doc maintenance from the agent.
How it compares
Obsidian vault MCP connector using your Claude subscription, not a standalone note-taking app or generic filesystem skill.
Common Questions / FAQ
Who is Margins for?
Solo builders who keep product and technical knowledge in Obsidian and want Claude Pro or Max to read and propose changes to those markdown files via MCP.
When should I use Margins?
While building and documenting—drafting specs, updating README-style notes, or refactoring vault structure with agent help grounded in your existing files.
How do I add Margins to my agent?
Add margins-mcp v0.15.3 to your MCP config (npx margins-mcp for stdio), point it at your Obsidian vault path per project docs, and use a client that supports Claude subscription flows as documented on marginsmcp.com.