Obsidian MCP Server
MCP server that lets AI assistants read, write, search and organize an Obsidian vault.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
Node.js 20.19 or newer
These steps ran from a folder named work in the home folder, which already existed. Make it and run them from there:
mkdir -p "$HOME/work" && cd "$HOME/work"Install packages globally
npm install -g @smith-and-web/obsidian-mcp-server mcp-remote
Verified in pickfit: the commands exactly as its sandbox ran them
For the record only: they name the sandbox's home, /home/sbx.
npm install -g @smith-and-web/obsidian-mcp-server mcp-remotels ~/.local/bin/ | grep -i -E "obsidian|mcp-remote|mcp"; which obsidian-mcp-server; which mcp-remote; mcp-remote --helpmkdir -p /home/sbx/work/vault && cat > /home/sbx/work/vault/welcome.md <<'EOF'
---
tags: [demo, test]
title: Welcome
---
# Welcome
This is a sample note with searchable content about pickfit verification.
See also [[other-note]] and #inline-tag.
## Section One
Details under section one.
EOF
cat > /home/sbx/work/vault/other-note.md <<'EOF'
# Other Note
Content linking back to [[welcome]] with unique word zyxwvu123.
EOF
ls -la /home/sbx/work/vault/ && cat /home/sbx/work/vault/welcome.mdVAULT_PATH=/home/sbx/work/vault PORT=3001 obsidian-mcp-servercurl http://localhost:3001/healthCheck that it works
ls ~/.local/bin/ | grep -i -E "obsidian|mcp-remote|mcp"; which obsidian-mcp-server; which mcp-remote; mcp-remote --helpThe output should contain “Usage: mcp-remote”.
First thing to try
mkdir -p "$HOME"/work/vault && cat > "$HOME"/work/vault/welcome.md <<'EOF'
---
tags: [demo, test]
title: Welcome
---
# Welcome
This is a sample note with searchable content about pickfit verification.
See also [[other-note]] and #inline-tag.
## Section One
Details under section one.
EOF
cat > "$HOME"/work/vault/other-note.md <<'EOF'
# Other Note
Content linking back to [[welcome]] with unique word zyxwvu123.
EOF
ls -la "$HOME"/work/vault/ && cat "$HOME"/work/vault/welcome.mdVAULT_PATH="$HOME"/work/vault PORT=3001 obsidian-mcp-servercurl http://localhost:3001/healthAdd it to your agent
claude mcp add obsidian-mcp-server -e VAULT_PATH='<VAULT_PATH>' -- mcp-remote http://127.0.0.1:3001/sseJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"obsidian-mcp-server": {
"command": "mcp-remote",
"args": [
"http://127.0.0.1:3001/sse"
],
"env": {
"VAULT_PATH": "<VAULT_PATH>"
}
}
}
}You fill in
VAULT_PATH: Path to Obsidian vault (required)
Ask the user for VAULT_PATH; pickfit never had a value, so these are placeholders.
Start the server with VAULT_PATH=<vault folder> PORT=3001 obsidian-mcp-server, then point your MCP client at it with mcp-remote http://127.0.0.1:3001/sse.
What it does
- Create, read, update and delete notesTested
How to use it
- Start the server with
VAULT_PATH=<vault folder> PORT=3001 obsidian-mcp-server. - Connect your MCP client through
mcp-remote http://127.0.0.1:3001/sse. - Ask the assistant to call the read-note tool with a note path such as <note>.md.
- Start the server with
- Search your notes by textTested
How to use it
- Start the server with
VAULT_PATH=<vault folder> PORT=3001 obsidian-mcp-server. - Connect your MCP client through
mcp-remote http://127.0.0.1:3001/sse. - Ask the assistant to call the search-vault tool with a query of <your text>.
- Start the server with
- Manage tags and frontmatter metadataTested
How to use it
- Start the server with
VAULT_PATH=<vault folder> PORT=3001 obsidian-mcp-server. - Connect your MCP client through
mcp-remote http://127.0.0.1:3001/sse. - Ask the assistant to call the list-tags tool to see the tags in your vault.
- Start the server with
- Search notes by meaningNot tested
How far pickfit got
Linux x86_64
- Installs
- Connects
- 3 of 4 features work
- Works offline
Good for
- read note contents
- create a new note
- full-text search vault with context
- find notes linking to a note
- list all tags with usage counts
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 1.12.0
An MCP client handshake over stdio listed 31 tools, and a call to read-note returned a result.
Differences the test machine hit
- README: VAULT_PATH=/path/to/your/vault npx @smith-and-web/obsidian-mcp-server and npx -y mcp-remote http://localhost:3001/sse
In the test: npm install -g @smith-and-web/obsidian-mcp-server mcp-remote, then run installed obsidian-mcp-server with VAULT_PATH/PORT; stdio clients/probe connect via mcp-remote http://127.0.0.1:PORT/sse - README: no --help/--version documented; server starts in foreground
In the test: obsidian-mcp-server --help starts the SSE server instead of printing help; use mcp-remote --help or the probe handshake to verify