How do I connect Obsidian MCP Server to Claude?

Run `claude mcp add stevenstavrakis-obsidian-mcp -- npx -y obsidian-mcp@2 serve --vault notes=/absolute/path/to/vault` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.

Is Obsidian MCP Server free?

The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Obsidian MCP Server do?

Obsidian MCP Server documents 12 tools to the agent, including obsidian_add_tags, obsidian_create_directory, obsidian_create_note. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Obsidian MCP

Unclaimed

by StevenStavrakis

A simple MCP server for Obsidian

Set up this server

Compare servers My Stack

01 / Choose your client

02 / Before you connect

Authentication is not specified. Check the project instructions before connecting.

Install the runtime required by the project and make it available to your client.

Project instructionsEnvironment variable names (optional)

Use names from the project instructions, separated by commas. Enter names only, never secret values.

03 / Add the configuration

Source: generated from public install instructions

claude mcp add --transport stdio 'stevenstavrakis-obsidian-mcp' -- 'npx' '-y' 'obsidian-mcp@2' 'serve' '--vault' 'notes=/absolute/path/to/vault'

Run in your terminal after replacing any placeholders.

04 / Check it in your client

Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

12 of 12 tools

Documented tools (12)

From project documentation. A server handshake does not verify each tool’s description or behavior.

obsidian_add_tags

Add tags to one or more notes atomically.

obsidian_create_directory

Transactionally create a directory inside a vault.

obsidian_create_note

Atomically create a note without overwriting.

obsidian_delete_note

Move a note to MCP trash or permanently delete it with explicit confirmation.

obsidian_edit_note

Append, prepend, or replace exact note content.

obsidian_list_vaults

List configured vault ids without exposing host paths.

obsidian_manage_tags

Unified add/remove tag workflow using the same implementation.

obsidian_move_note

Move or rename a note and update unambiguous backlinks transactionally.

obsidian_read_note

Read a bounded page of a note and return its SHA-256 etag.

obsidian_remove_tags

Remove exact, nested, or wildcard-selected tags atomically.

obsidian_rename_tag

Rename a tag across the vault atomically.

obsidian_search_vault

Search content, filenames, or tags with bounded cursor pagination.

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Obsidian MCP Server

How do I connect Obsidian MCP Server to Claude?: Run `claude mcp add stevenstavrakis-obsidian-mcp -- npx -y obsidian-mcp@2 serve --vault notes=/absolute/path/to/vault` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
Is Obsidian MCP Server free?: The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Obsidian MCP Server do?: Obsidian MCP Server documents 12 tools to the agent, including obsidian_add_tags, obsidian_create_directory, obsidian_create_note. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.