Margins
This server turns Claude Desktop into a read/write interface for your Obsidian vault or any markdown folder. You get tools for full-text search, page reads, backlink traversal, and a proposal system that stages all writes to a review folder before they touch your notes. It can compile PDFs, Word docs, spreadsheets, and email exports from a raw folder into structured wiki pages. The workflow is subscription-based, no API keys, and every edit requires explicit acceptance via resolve_proposal. Useful if you want to query your personal knowledge base in Claude without setting up embeddings or paying per token, and you're comfortable with a file-based review loop instead of live writes.
- GitHub stars
- 1
- tools
- 16
- transport
- STDIO
- last updated
- May 21, 2026
Tools
16 toolsPublic tool metadata for what this MCP can expose to an agent.
margins_startVault stats + pending proposals + uningested raw files + recent preferences + the vault's `CLAUDE.md` if present.
Vault stats + pending proposals + uningested raw files + recent preferences + the vault's `CLAUDE.md` if present.
No parameter schema in public metadata yet.
recall_preferencesRead durable user preferences from `.margins/preferences.md` (filing conventions, naming patterns, prior corrections).
Read durable user preferences from `.margins/preferences.md` (filing conventions, naming patterns, prior corrections).
No parameter schema in public metadata yet.
search_vaultFull-text + filename search across the vault.
Full-text + filename search across the vault.
No parameter schema in public metadata yet.
read_pageRead one page by relative path.
Read one page by relative path.
No parameter schema in public metadata yet.
list_recentMost recently modified pages.
Most recently modified pages.
No parameter schema in public metadata yet.
get_backlinksPages that wikilink to a target slug.
Pages that wikilink to a target slug.
No parameter schema in public metadata yet.
searchChatGPT Deep Research compatibility pair.
ChatGPT Deep Research compatibility pair.
No parameter schema in public metadata yet.
fetchChatGPT Deep Research compatibility pair.
ChatGPT Deep Research compatibility pair.
No parameter schema in public metadata yet.
propose_pageStage a new page at `proposed/<path>`.
Stage a new page at `proposed/<path>`.
No parameter schema in public metadata yet.
propose_editStage a string-replacement edit. `before` must appear exactly once.
Stage a string-replacement edit. `before` must appear exactly once.
No parameter schema in public metadata yet.
append_toStage an append. Creates the page if missing; stacks on pending proposals.
Stage an append. Creates the page if missing; stacks on pending proposals.
No parameter schema in public metadata yet.
propose_compile_from_rawTurn a raw transcript, note, PDF, Word doc, spreadsheet, deck, email, EPUB, or other supported document in `raw/` into a structured source page.
Turn a raw transcript, note, PDF, Word doc, spreadsheet, deck, email, EPUB, or other supported document in `raw/` into a structured source page.
No parameter schema in public metadata yet.
list_proposalsList pending proposals + overwrite-risk flag per entry.
List pending proposals + overwrite-risk flag per entry.
No parameter schema in public metadata yet.
resolve_proposal`action: "accept"` lands the proposal; `action: "reject"` discards it.
`action: "accept"` lands the proposal; `action: "reject"` discards it.
No parameter schema in public metadata yet.
propose_wikilinksScan a page for entity-shaped phrases and propose wikilinks to other vault pages that share the same slug.
Scan a page for entity-shaped phrases and propose wikilinks to other vault pages that share the same slug.
No parameter schema in public metadata yet.
record_preferenceAppend a durable rule to `.margins/preferences.md`.
Append a durable rule to `.margins/preferences.md`.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
margins-mcp
Use your Claude Pro/Max subscription on your Obsidian vault. No API key. No per-token costs. No embedding pipelines. Claude reads your notes and proposes updates; your subscription pays for inference; your files stay on your disk.
margins-mcp is a small Node program that sits between Claude (Desktop or Code) and your Obsidian vault. When you chat with Claude, it reads your notes through margins-mcp. Your files stay local, Claude does the thinking, your existing subscription pays for it.
Which Margins are you?
Margins works for six common starting points. margins_start auto-detects your state on the first call, so you don't have to classify yourself — but knowing which row you're on helps set expectations.
Details
- Repository
- github.com/cflorczyk9/margins
- Website
- marginsmcp.com
- Categories
- Documents & Knowledge, Finance & Commerce
- Package
margins-mcp- Transport
- STDIO
- Registry
- MCP registry, active
Related Documents & Knowledge MCP servers
View all
shuck-convertshan-zhu/shuck-convertConvert between document formats — DOCX/PDF to Markdown, Markdown to DOCX.1stars
FastMCP server for Obsidian wikilink suggestions from a pre-computed knowledge gadelaidasofia/graph-autotagger-mcpFastMCP server for Obsidian wikilink suggestions from a pre-computed knowledge graph (graphify…0stars
AutEng Docs — Agent Document Workspace & Publishingai.auteng/docsAgent document workspace with wallet auth. Create, update and share markdown docs. By AutEng.ai0stars
PageTranslatecaravaca-labs/pagetranslate-mcpTranslate PDF, scanned PDF, DOCX and EPUB files into 70+ languages with the layout kept.0stars
Prince Cloudcloud.prince/princeConvert Markdown, HTML, and web pages to high-quality PDF with Prince.0stars
Hjarnihjarni/hjarni-mcpMarkdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.0stars