Skip to content
The Daily Repo

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

Repos similar to this one
RepoStarsLast commitLicenceDownloads for
sparfenyuk / mcp-proxy2,8192 days agoMITNo downloads
haris-musa / excel-mcp-server4,2845 days agoMITNo downloads
neo4j-contrib / mcp-neo4j9892 months agoMITNo 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

Type to search.

Try