obsidian-mcp-server
bycyanheads· 15 MCP servers
</div>
How to install obsidian-mcp-server?
cyanheads/obsidian-mcp-server
$git clone https://github.com/cyanheads/obsidian-mcp-serverInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install obsidian-mcp-server by running `git clone https://github.com/cyanheads/obsidian-mcp-server`, then use it for the current task and follow its documentation at https://github.com/cyanheads/obsidian-mcp-server.
README.md
| 1 | <div align="center"> |
| 2 | <h1>obsidian-mcp-server</h1> |
| 3 | <p><b>Read, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP. STDIO or Streamable HTTP.</b> |
| 4 | <div>14 Tools • 3 Resources</div> |
| 5 | </p> |
| 6 | </div> |
| 7 | |
| 8 | <div align="center"> |
| 9 | |
| 10 | [](./CHANGELOG.md) [](./LICENSE) [](https://github.com/users/cyanheads/packages/container/package/obsidian-mcp-server) [](https://modelcontextprotocol.io/) [](https://www.npmjs.com/package/obsidian-mcp-server) [](https://www.typescriptlang.org/) [](https://bun.sh/) |
| 11 | |
| 12 | </div> |
| 13 | |
| 14 | <div align="center"> |
| 15 | |
| 16 | [](https://github.com/cyanheads/obsidian-mcp-server/releases/latest/download/obsidian-mcp-server.mcpb) [](https://cursor.com/en/install-mcp?name=obsidian-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm9ic2lkaWFuLW1jcC1zZXJ2ZXIiXSwiZW52Ijp7Ik9CU0lESUFOX0FQSV9LRVkiOiJ5b3VyLWFwaS1rZXkifX0=) [](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22obsidian-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22obsidian-mcp-server%22%5D%2C%22env%22%3A%7B%22OBSIDIAN_API_KEY%22%3A%22your-api-key%22%7D%7D) |
| 17 | |
| 18 | [](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) |
| 19 | |
| 20 | </div> |
| 21 | |
| 22 | --- |
| 23 | |
| 24 | ## Tools |
| 25 | |
| 26 | Fourteen tools grouped by shape — readers fetch notes and metadata, writers create or surgically edit content, managers reconcile tags and frontmatter, and a guarded escape hatch dispatches Obsidian command-palette commands. |
| 27 | |
| 28 | | Tool Name | Description | |
| 29 | |:----------|:------------| |
| 30 | | `obsidian_get_note` | Read a note as raw content, full structured form (content + frontmatter + tags + stat, with optional outgoing links), structural document map, or a single section. | |
| 31 | | `obsidian_list_notes` | List notes and subdirectories under a vault path. Recursive walk (default depth 2, max depth 20; 1000-entry cap) with optional `extension` and `nameRegex` filters. | |
| 32 | | `obsidian_list_tags` | List every tag found across the vault with usage counts, including hierarchical parents. Optional `nameRegex` post-filters the result set. | |
| 33 | | `obsidian_list_commands` | List Obsidian command-palette commands, optionally filtered by `nameRegex` on display name. **Opt-in via `OBSIDIAN_ENABLE_COMMANDS=true`** (paired with `obsidian_execute_command`). | |
| 34 | | `obsidian_search_notes` | Search the vault by text, JSONLogic, or BM25-ranked Omnisearch (when the plugin is reachable). Results paginate via opaque cursors. | |
| 35 | | `obsidian_write_note` | Create a note, replace a single section in place, or — with `overwrite: true` — clobber an existing file. Refuses whole-file writes against an existing path by default. | |
| 36 | | `obsidian_append_to_note` | Append content to a note. Without `section`, creates the file if missing. With `section`, appends to a specific heading, block, or frontmatter field (file must exist). | |
| 37 | | `obsidian_patch_note` | Surgical `append` / `prepend` / `replace` against a heading, block reference, or frontmatter fiel |
Related
6 picksType
- Context7Up-to-date library docs injected straight into your promptstoday
- repomixA tool to pack repository contents to single file for AI consumptionJul 2026
- markitdown-mcpA Model Context Protocol server for converting documents to Markdown using MarkItDownJun 2026
- anytype-mcpOfficial MCP server for Anytype API - your encrypted, local and collaborative wiki.Jul 2026
- mcp-server-atlassian-confluenceNode.js/TypeScript MCP server for Atlassian Confluence. Provides tools enabling AI systems (LLMs) to list/get spaces & pages (content formatted as Markdown) and search via CQL. Connects AI seamlessly to Confluence knowledge bases using the standard MCP interface.Feb 2026
- obsidian-mcp-server-enhancedThis is an enhanced version of the excellent cyanheads/obsidian-mcp-server with additional features specifically tailored for remote Claude.ai integration, advanced task querying, and security via Tailscale.Jul 2026
