Obsidian Local Rest Api MCP Server

AI-Native MCP server for Obsidian vaults with task-oriented, intelligent tools designed for LLM workflows

Local serverstdioTypeScript

What is the Obsidian Local Rest Api MCP Server?

AI-Native MCP server for Obsidian vaults with task-oriented, intelligent tools designed for LLM workflows.

What Obsidian Local Rest Api MCP does

An AI-Native MCP (Model Context Protocol) server that provides intelligent, task-oriented tools for interacting with Obsidian vaults through a local REST API.

Requirements

Practical notes

  • Maintained by j-shelfwood, written in TypeScript.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_directory
read_file
write_file
delete_item
create_or_update_note
get_daily_note
get_recent_notes
search_vault
find_related_notes

How to install the Obsidian Local Rest Api MCP Server

{
  "mcpServers": {
    "obsidian-vault": {
      "command": "npx",
      "args": [
        "obsidian-local-rest-api-mcp"
      ],
      "env": {
        "OBSIDIAN_API_URL": "http://obsidian-local-rest-api.test",
        "OBSIDIAN_API_KEY": "YOUR_OBSIDIAN_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
OBSIDIAN_API_URLDeclared in the maintainer’s client configuration.Check documentation
OBSIDIAN_API_KEYDeclared in the maintainer’s client configuration.Yes

Example prompts to try

  • “Use Obsidian Local Rest Api MCP to list directory.”
  • “Use Obsidian Local Rest Api MCP to read file.”
  • “Use Obsidian Local Rest Api MCP to write file.”

Frequently asked questions

AI-Native MCP server for Obsidian vaults with task-oriented, intelligent tools designed for LLM workflows Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.