cyanheads / obsidian-mcp-server
Read, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP. STDIO or Streamable HTTP.
Why this job: name: mcp; says: mcp server; topics: mcp-server, model-context-protocol, mcp
What it does
- target is a vault path, the active file, or a periodic note (daily through yearly, optional date); format is content, full, document-map, or section, and full takes includeLinks: true for vault-internal outgoing links
- result.format discriminates the payload; a section read that matches several headings returns the first and lists every full path in candidates
- A path with no exact match but one case-insensitive match in its folder reads that file: result.path is the real name, requestedPath the one sent, and a notice names both
- Walks from path (default vault root) to depth 1–20 (default 2), filtered by extension and nameRegex (≤256 chars); a folder that fails nameRegex is not walked
- Returns entries[] (file / directory), totals, and appliedFilters; the walk stops at 1,000 entries with excluded.reason: "entry_cap", and a folder the depth limit stopped carries truncated: true
Get started
No single install command. Read the steps in the README (opens in new tab)
- Maintenance
- Active
- Last commit 9 days ago
- Stars
- 702
- +4 this week
- Licence
- Apache-2.0
- Allows business use
- Downloads for
- None listed
- No release files
- Latest version
- v3.8.0
- Released 9 days ago
- Built with
- TypeScript
- 100% of the code
Is it looked after?
- Contributors
- 1
- Last 90 days
- Issues
- 91% closed
- 11 still open
- Pull requests
- 13 merged
- 6 waiting
- Releases
- 26
- 26 in the last year
Similar repos
| Repo | Stars | Last commit | Licence | Downloads for |
|---|---|---|---|---|
| sparfenyuk / mcp-proxy | 2,819 | 2 days ago | MIT | No downloads |
| haris-musa / excel-mcp-server | 4,284 | 5 days ago | MIT | No downloads |
| neo4j-contrib / mcp-neo4j | 989 | 2 months ago | MIT | No downloads |
More: languages, topics and project record
Languages
- TypeScript 100%
- Dockerfile <1%
Topics
- ai-agents
- ai-tools
- bun
- cyanheads
- knowledge-base
- mcp
- mcp-server
- model-context-protocol
- note-taking
- obsidian
- obsidian-md
- obsidian-vault
Project record
- JobMCP servers
- StatusListed
- Commits378
- Forks107
- Watching7
- Stars in 28 days+10
- CreatedJan 23, 2025
- First seen by usNov 7, 2026
- CheckedNov 7, 2026
