Obsidian Notes MCP server

Install in Claude Desktop

Download the bundle for your Mac or PC from the latest release, open it, point it at your vault.

About "Not signed"

The bundles are unsigned. That is normal for .mcpb: mcpb pack does not sign by default, and signing is a separate opt-in step with a certificate of your own. If you run mcpb info on the download you will see WARNING: Not signed — ignore it. It has no effect on installing or using the extension.

Signing is not enabled yet because the upstream tooling is currently broken: mcpb sign produces a bundle that Claude Desktop refuses to install (#278), and mcpb verify reports signed bundles as unsigned (#276). It will be added once those are fixed.

MCP tool using obsidian

• going with the idea that it's better to search for local information using tags and search over RAG.
• more possible with the Open Knowledge Format (OKF) that Google is encouraging. Which mostly uses markdown.
• markdown, notes, and better access to local info makes me think there should be an app to connect an LLM to obsidian.

Goals

• have tool check notes using: title, tags, and follow links in notes
• to have as a vault for llm to make notes. To solve problems, document it, and see if new problems are similar.

Non-goals

• create a full GUI interface for the app
• to allow RAG use

Install

cargo install mcp-obsidian

Then point it at a vault:

mcp-obsidian --vault ~/vault index      # print the index, no model involved
mcp-obsidian --vault ~/vault serve      # stdio MCP server for a desktop host
mcp-obsidian --vault ~/vault serve --http   # Streamable HTTP on 127.0.0.1:8000/mcp

Marketplaces

Published on crates.io:

cargo install mcp-obsidian
mcp-obsidian --vault ~/vault serve

The crate is dual-licensed and its README carries the registry ownership token, so it can also be listed in the Official MCP Registry and shipped as an MCPB bundle without further changes.

requires.

• PUBLISHING.md — release runbook and the account each directory

plus the Smithery and ChatGPT directory submissions and the OAuth they need.

• DEPLOYMENT.md — hosting behind a public HTTPS URL on a VPS,

The line below is the package-ownership token the registry verifies against this crate's README. It must stay visible in plain text — crates.io strips HTML comments — and must match the name in server.json.

mcp-name: io.github.moreno-omar/mcp-obsidian

Demo

Everything below runs locally on one desktop — an NVIDIA RTX 4060 Ti (16 GB) serving gemma4:e4b through Ollama, with the vault read from disk. No API keys, no cloud calls, no data leaving the machine: the only network traffic is localhost:11434.

ask — one prompt, answered from the vault

chat — the same loop, interactive

Fast, because this is a CLI and not a full-fledged TUI

mcp-obsidian prints, it does not paint. There is no alternate screen, no event loop and no per-frame redraw: colours and layout are computed once per answer with richrs, written to stdout, and the process exits. Measured on the machine above:

Shortened. The full README is on GitHub.