Obsidian MCP Server vs Obsidian Notes
A side-by-side look at the Obsidian MCP Server and Obsidian Notes MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.
Verdict: choose Obsidian MCP Server for knowledge & memory work as a local process; choose Obsidian Notes for knowledge & memory. You can also run both side by side in one mcpServers block.
Which MCP server should you choose?
Choose Obsidian MCP Server when
- You need dedicated capabilities in the Knowledge & Memory domain.
- You prefer a local stdio subprocess transport.
- You have the keys it needs:
OBSIDIAN_API_KEY. - You want tools like
obsidian_get_note, obsidian_list_notes, obsidian_list_tags.
Choose Obsidian Notes when
- You need dedicated capabilities in the Knowledge & Memory domain.
Feature & specification comparison
Rows where the two servers differ are marked.
| Spec | ||
|---|---|---|
| Category | Knowledge & Memory | Knowledge & Memory |
| Quality signal | 65/100 · Great | 33/100 · Emerging |
| Install command | Confirmed | Not confirmed yet |
| Transport | Local subprocess (stdio) | — |
| Auth | Not declared | Not declared |
| Pricing | Not declared | Not declared |
| Required env vars | OBSIDIAN_API_KEY | None listed |
| Verified owner | Community listing | Community listing |
| GitHub stars | 701 | 0 |
| Directory activity | 5 views 0 installs 0 upvotes | 0 views 0 installs 0 upvotes |
| Tools | 14 | Not listed |
| Full listing | View Obsidian MCP Server | View Obsidian Notes |
Tools & capabilities
Obsidian MCP Server tools 14
obsidian_get_noteRead a note as raw content, full structured form, document map, or a single sectionobsidian_list_notesList notes and folders under a vault path, recursively, with extension and name filtersobsidian_list_tagsList vault tags with usage counts, most-used firstobsidian_search_notesSearch by text, JSONLogic, or BM25-ranked Omnisearch when that plugin is reachableobsidian_write_noteCreate a note, replace one section, or overwrite a whole file with `overwrite: trueobsidian_append_to_noteAppend to a note (creating it if missing) or to one heading, block, or frontmatter fieldobsidian_patch_noteAppend, prepend, or replace against one heading, block reference, or frontmatter fieldobsidian_replace_in_noteLiteral or regex search-replace inside one note, body-only by defaultobsidian_manage_frontmatterGet, set, or delete one frontmatter keyobsidian_manage_tagsAdd, remove, or list a note's tags in frontmatter, inline, or bothobsidian_delete_notePermanently delete a note, optionally after the user confirms (`OBSIDIAN_DELETE_ELICITATION`)obsidian_open_in_uiOpen a file in the Obsidian app, optionally in a new pane- +2 more on the listing page
Obsidian Notes tools
No tool names declared yet. Check the project README from the listing page.
Ready-to-paste client configs
Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.
Obsidian MCP Server
{
"mcpServers": {
"obsidian-mcp-server": {
"command": "bunx",
"args": [
"obsidian-mcp-server@latest"
],
"env": {
"OBSIDIAN_API_KEY": "YOUR_OBSIDIAN_API_KEY_HERE"
}
}
}
}
Obsidian Notes
No confirmed install command for Obsidian Notes yet — follow the setup steps linked from its listing page rather than a guessed package name.