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
Rust Docs MCP Server
Govcraft🦀 Prevents outdated Rust code suggestions from AI assistants. This MCP server fetches current crate docs, uses embeddings/LLMs, and provides accurate context via a tool call.
MCP Apple Notes
RafalWilinskiTalk with your notes in Claude. RAG over your Apple Notes using Model Context Protocol.
Mcp Knowledge Graph
shanehollomanMCP server enabling persistent memory for Claude through a local knowledge graph - fork focused on local development
Ultimate Google Docs & Drive MCP Server
a-bonusThe Ultimate Google Docs, Sheets, Drive, Gmail, & Google Calendar MCP Server. This MCP (primarily for use in Claude Desktop) gains full access to your google suite and lets claude do its thing.
Jupyter Notebook MCP Server (for Cursor)
jbenoModel Context Protocol (MCP) server designed to allow AI agents within Cursor to interact with Jupyter Notebook (.ipynb) files
Comments