MCP server for Obsidian
@MarkusPfundstein
About MCP server for Obsidian
MCP server that interacts with Obsidian via the Obsidian rest API community plugin
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-obsidian": {
"command": "uvx",
"args": [
"mcp-obsidian"
],
"env": {
"OBSIDIAN_API_KEY": "<your_api_key_here>",
"OBSIDIAN_HOST": "<your_obsidian_host>",
"OBSIDIAN_PORT": "<your_obsidian_port>"
}
}
}
}Tools
7Lists all files and directories in the root directory of your Obsidian vault
Lists all files and directories in a specific Obsidian directory
Return the content of a single file in your vault.
Search for documents matching a specified text query across all files in the vault
Insert content into an existing note relative to a heading, block reference, or frontmatter field.
Append content to a new or existing file in the vault.
Delete a file or directory from your vault.
Overview
What is MCP server for Obsidian?
MCP server to interact with Obsidian via the Local REST API community plugin. It allows MCP clients (like Claude Desktop) to read, search, and modify notes in an Obsidian vault.
How to use MCP server for Obsidian?
First install and enable the Obsidian Local REST API plugin, then copy the API key. Configure the server by setting OBSIDIAN_API_KEY, OBSIDIAN_HOST (default 127.0.0.1), and OBSIDIAN_PORT (default 27124) either in the MCP server config or a .env file. Run the server via uvx mcp-obsidian or using the development configuration with uv.
Key features of MCP server for Obsidian
- List all files and directories in the vault root
- List files in a specific Obsidian directory
- Get the full content of any single file
- Search for documents matching a text query
- Insert content relative to a heading, block, or frontmatter field
- Append content to a new or existing file
- Delete a file or directory from the vault
Use cases of MCP server for Obsidian
- Retrieve and summarize the last architecture call note
- Search all vault files mentioning a topic like Azure CosmosDb
- Summarize meeting notes and save them as a new note with an email‐ready introduction
FAQ from MCP server for Obsidian
What is MCP server for Obsidian?
It is a Model Context Protocol server that enables MCP clients to read, search, and edit notes in Obsidian through the Local REST API plugin.
What are the prerequisites to use MCP server for Obsidian?
You need Obsidian with the Local REST API community plugin installed and enabled, and the API key from that plugin’s configuration.
How do I configure environment variables?
Set OBSIDIAN_API_KEY, OBSIDIAN_HOST (default 127.0.0.1), and OBSIDIAN_PORT (default 27124) either in the MCP server JSON config under env or in a .env file in the working directory.
What tools does MCP server for Obsidian provide?
It provides seven tools: list_files_in_vault, list_files_in_dir, get_file_contents, search, patch_content, append_content, and delete_file.
Where does the data live?
All data resides in your Obsidian vault on your local machine. The server accesses it via the Obsidian Local REST API plugin, which runs locally.
More Memory & Knowledge MCP servers
minutes
silversteinEvery meeting, every idea, every voice note — searchable by your AI. Open-source, privacy-first conversation memory layer.
Dash Api Docs Mcp Server
KapeliMCP server for Dash, the macOS API documentation browser
Notion MCP Server
awkoyNotion MCP server for Claude, Cursor, ChatGPT & Claude Desktop. Connect AI agents to Notion via Model Context Protocol — pages, databases, blocks, comments, files.
mcp-local-rag
nkapila6"primitive" RAG-like web search model context protocol (MCP) server that runs locally. ✨ no APIs ✨
Obsidian MCP Server
StevenStavrakisA simple MCP server for Obsidian
Comments