O

Obsidian MCP

Read and edit notes in your local Obsidian vault.

Obsidian·No reviews yet
Repo Docs
Share:

About

Search notes across a local Obsidian vault, read markdown files with frontmatter parsed, create and update notes, and follow backlinks. Works with the Local REST API community plugin. Ideal for personal knowledge assistants and journaling agents.

Example tools

Illustrative tool names — the actual tool set is defined by the server at runtime.

create_task
Create a new task
list_tasks
List tasks with filters
update_task
Update fields of an existing task

Screenshots

No screenshots yet.

Frequently Asked Questions

Common questions about Obsidian MCP.

What is the Obsidian MCP used for?
The Obsidian MCP facilitates interaction with a local Obsidian vault. It allows agents to search, read, and update markdown notes, and to follow backlinks. This is useful for personal knowledge management and journaling applications.
How do I configure the Obsidian MCP in a client?
To configure the Obsidian MCP, you will need to specify the transport type as 'stdio' and provide your API key. The specific setup steps depend on the MCP client you are using, but generally involve entering these details into the client's MCP configuration interface.
Does the Obsidian MCP require an API key?
Yes, access to the Obsidian MCP requires an API key for authentication. This key is used to secure interactions with your local Obsidian vault through the MCP server.
What are the core capabilities of the Obsidian MCP?
The Obsidian MCP enables agents to search notes, read markdown files with parsed frontmatter, create and update notes, and follow backlinks within an Obsidian vault. These capabilities support dynamic interaction with your knowledge base.
Is there a cost associated with using the Obsidian MCP?
The Obsidian MCP itself is open source and available on GitHub, implying no direct cost for the MCP server software. Any costs would depend on your Obsidian setup and potential community plugins used, such as the Local REST API plugin.
What is a prerequisite for using the Obsidian MCP?
A key prerequisite for using the Obsidian MCP is having the Local REST API community plugin installed and configured within your Obsidian application. The MCP relies on this plugin to interact with your local vault.

Install Obsidian MCP

Claude Desktop

Add this to claude_desktop_config.json.

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-obsidian"
      ]
    }
  }
}

Cursor

Add this to ~/.cursor/mcp.json.

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-obsidian"
      ]
    }
  }
}

VS Code

Add this to your workspace settings.json.

{
  "mcp.servers": {
    "obsidian": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-obsidian"
      ]
    }
  }
}

Reviews

Sign in to leave a review.

No reviews yet. Be the first!

Discussion(0)

Sign in to join the discussion.

No comments yet.