Obsidian MCP Server

Name: Obsidian MCP Server
Author: cyanheads

obsidian-mcp-server · by cyanheads

Read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP.

704 4.0k/wk 14 tools GitHub npm

No known CVEs

Apache-2.0 license

Actively maintained

Last commit 1d ago

Works with most clients

Transport: stdio, sse, http

14 tools · ~1.4k tok

Grade B · 0.7% of 200K ctx

MCPpedia last refreshed this data 1d ago

Edit this pageView history

Obsidian MCP Server is an MCP server that read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP. Its tool list has not been published yet over stdio, sse and http, requires no API key, and scores 88/100 on MCPpedia's security, maintenance and efficiency rubric.

Productivity

Step 1

Install in your client

Config is the same across clients - only the file and path differ.

Supported in Claude Desktopstdio, sse, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "env": {
        "OBSIDIAN_API_KEY": "YOUR_API_KEY_FROM_OBSIDIAN_PLUGIN",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123",
        "OBSIDIAN_VERIFY_SSL": "false",
        "OBSIDIAN_ENABLE_CACHE": "true"
      },
      "args": [
        "obsidian-mcp-server"
      ],
      "command": "npx",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/obsidian-mcp-server)](https://mcppedia.org/s/obsidian-mcp-server)

Read me

What Obsidian Mcp Server does

Read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP.

Test This Server

This server supports HTTP transport. Be the first to test it - help the community know if it works.

Loading README…

Scored, not listed

Why this score

Five weighted categories - click any category to see the underlying evidence.

Score breakdown

88/100across 5 weighted dimensions

How we score →

0255075100

−12

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked obsidian-mcp-server against OSV.dev.

Inventory

Tools (14)

Click any tool to inspect its schema.

~1.4k tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience - it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Obsidian Mcp Server safe to use?: Obsidian Mcp Server has no known CVEs as of the latest MCPpedia security scan. Authentication requirements were not detected automatically - check the project's documentation before connecting in a shared environment. Licensed under Apache-2.0.
How do I install Obsidian Mcp Server?: Obsidian Mcp Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Obsidian Mcp Server do?: Obsidian Mcp Server provides 14 tools: obsidian_get_note, obsidian_list_notes, obsidian_list_tags, obsidian_list_commands, obsidian_search_notes and 9 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Obsidian Mcp Server?: Obsidian Mcp Server is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.
Is Obsidian Mcp Server actively maintained?: Obsidian Mcp Server is actively maintained - last commit was 1 day ago. It has 704 GitHub stars.

Similar servers

Others in productivity

View all →

Anytype Mcp95

Official MCP server for Anytype API - your encrypted, local and collaborative wiki.

542 4

com.monday/monday.com93

MCP server for monday.com integration.

437 4

Obsidian Sync MCP Server93

Give AI agents access to your Obsidian vault via local files or Self-hosted LiveSync.

72 9

Windows MCP92

An MCP Server for computer-use in Windows OS

11.6k 5

MCP Security Weekly

Get CVE alerts and security updates for Obsidian Mcp Server and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

{ "mcpServers": { "obsidian-mcp-server": { "env": { "OBSIDIAN_API_KEY": "YOUR_API_KEY_FROM_OBSIDIAN_PLUGIN", "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123", "OBSIDIAN_VERIFY_SSL": "false", "OBSIDIAN_ENABLE_CACHE": "true" }, "args": [ "obsidian-mcp-server" ], "command": "npx", "disabled": false, "autoApprove": [] } } }

Overview

Your Obsidian vault, through the Local REST API plugin. Read, search, and write notes, edit a single heading, block, or frontmatter field in place, and manage tags, with folder-scoped read/write permissions built in.

Tools

Tool

Description

obsidian_get_note

Read a note as raw content, full structured form, document map, or a single section

obsidian_list_notes

List notes and folders under a vault path, recursively, with extension and name filters

obsidian_list_tags

List vault tags with usage counts, most-used first

obsidian_search_notes

Search by text, JSONLogic, or BM25-ranked Omnisearch when that plugin is reachable and reads are unscoped

obsidian_write_note

Create a note, replace one section, or overwrite a whole file with overwrite: true

obsidian_append_to_note

Append to a note (creating it if missing) or to one heading, block, or frontmatter field

obsidian_patch_note

Append, prepend, or replace against one heading, block reference, or frontmatter field

obsidian_replace_in_note

Literal or regex search-replace inside one note, body-only by default

obsidian_manage_frontmatter

Get, set, or delete one frontmatter key

obsidian_manage_tags

Add, remove, or list a note's tags in frontmatter, inline, or both

obsidian_delete_note

Permanently delete a note, optionally after the user confirms (OBSIDIAN_DELETE_ELICITATION)

obsidian_open_in_ui

Open a file in the Obsidian app, optionally in a new pane

obsidian_list_commands

List command-palette commands (opt-in via OBSIDIAN_ENABLE_COMMANDS)

obsidian_execute_command

Run a command-palette command by ID (opt-in via `OB

Frequently Asked Questions

Is Obsidian Mcp Server safe to use?

Obsidian Mcp Server has no known CVEs as of the latest MCPpedia security scan. Authentication requirements were not detected automatically - check the project's documentation before connecting in a shared environment. Licensed under Apache-2.0.

How do I install Obsidian Mcp Server?

Obsidian Mcp Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can Obsidian Mcp Server do?

Obsidian Mcp Server provides 14 tools: obsidian_get_note, obsidian_list_notes, obsidian_list_tags, obsidian_list_commands, obsidian_search_notes and 9 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with Obsidian Mcp Server?

Obsidian Mcp Server is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.

Is Obsidian Mcp Server actively maintained?

Obsidian Mcp Server is actively maintained - last commit was 1 day ago. It has 704 GitHub stars.

obsidian-mcp-server

Read, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP. STDIO or Streamable HTTP.

14 Tools • 3 Resources

Overview

Tools

Tool	Description
`obsidian_get_note`	Read a note as raw content, full structured form, document map, or a single section
`obsidian_list_notes`	List notes and folders under a vault path, recursively, with extension and name filters
`obsidian_list_tags`	List vault tags with usage counts, most-used first
`obsidian_search_notes`	Search by text, JSONLogic, or BM25-ranked Omnisearch when that plugin is reachable and reads are unscoped
`obsidian_write_note`	Create a note, replace one section, or overwrite a whole file with `overwrite: true`
`obsidian_append_to_note`	Append to a note (creating it if missing) or to one heading, block, or frontmatter field
`obsidian_patch_note`	Append, prepend, or replace against one heading, block reference, or frontmatter field
`obsidian_replace_in_note`	Literal or regex search-replace inside one note, body-only by default
`obsidian_manage_frontmatter`	Get, set, or delete one frontmatter key
`obsidian_manage_tags`	Add, remove, or list a note's tags in frontmatter, inline, or both
`obsidian_delete_note`	Permanently delete a note, optionally after the user confirms (`OBSIDIAN_DELETE_ELICITATION`)
`obsidian_open_in_ui`	Open a file in the Obsidian app, optionally in a new pane
`obsidian_list_commands`	List command-palette commands (opt-in via `OBSIDIAN_ENABLE_COMMANDS`)
`obsidian_execute_command`	Run a command-palette command by ID (opt-in via `OB

... View full README on GitHub