Obsidian

MCP server to interact with Obsidian via the Local REST API community plugin.

The server implements multiple tools to interact with Obsidian:

- list_files_in_vault: Lists all files and directories in the root directory of your Obsidian vault
- list_files_in_dir: Lists all files and directories in a specific Obsidian directory
- get_file_contents: Return the content of a single file in your vault.
- search: Search for documents matching a specified text query across all files in the vault
- patch_content: Insert content into an existing note relative to a heading, block reference, or frontmatter field.
- append_content: Append content to a new or existing file in the vault.

Its good to first instruct Claude to use Obsidian. Then it will always call the tool.

- Get the contents of the last architecture call note and summarize them
- Search for all files where Azure CosmosDb is mentioned and quickly explain to me the context in which it is mentioned
- Summarize the last meeting notes and put them into a new note 'summary meeting.md'. Add an introduction so that I can send it via email.

There are two ways to configure the environment with the Obsidian REST API Key.

{ "mcp-obsidian": { "command": "uvx", "args": [ "mcp-obsidian" ], "env": { "OBSIDIAN_API_KEY":"<your_api_key_here>" } }

- Create a.envfile in the working directory with the following required variable:

Note: You can find the key in the Obsidian plugin config.

You need the Obsidian REST API community plugin running:https://github.com/coddingtonbear/obsidian-local-rest-api

{ "mcpServers": { "mcp-obsidian": { "command": "uv", "args": [ "--directory", "<dir_to>/mcp-obsidian", "run", "mcp-obsidian" ] } } }

{ "mcpServers": { "mcp-obsidian": { "command": "uvx", "args": [ "mcp-obsidian" ], "env": { "OBSIDIAN_API_KEY" : "<YOUR_OBSIDIAN_API_KEY>" } } } }

To prepare the package for distribution:

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using theMCP Inspector.

You can launch the MCP Inspector vianpmwith this command:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-obsidian run mcp-obsidian

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-obsidian.log

Interact with Obsidian vaults to read, create, edit, and manage notes and tags.