MCP.so
Sign In

OBSIDIAN-MCP-SERVER

@zerogon1203

Repository

About OBSIDIAN-MCP-SERVER

No overview available yet

#obsidian#mcp#server

Basic information

Category

Memory & Knowledge

Runtime

python

Transports

stdio

Publisher

zerogon1203

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "obsidian-mcp-server-zerogon1203": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is OBSIDIAN-MCP-SERVER?

OBSIDIAN-MCP-SERVER is a Model Context Protocol (MCP) Stdio server that allows LLM agents to interact with Obsidian. It provides Python‑based functions for managing Obsidian vaults and files.

How to use OBSIDIAN-MCP-SERVER?

Clone the repository, create a Python virtual environment, install dependencies from requirements.txt, set the OBSIDIAN_VAULT_PATH environment variable to your Obsidian vault path, and run python main.py. You can then invoke JSON‑RPC methods (e.g., create_vault, list_vaults, write_vault_file) via stdio. For Cursor, add a configuration entry with the command pointing to your virtual environment’s Python and the script’s file path.

Key features of OBSIDIAN-MCP-SERVER

  • Create, delete, list, and inspect Obsidian vaults
  • Change vault settings
  • List, write, and delete files inside a vault

Use cases of OBSIDIAN-MCP-SERVER

  • An LLM agent automatically creates and populates new Obsidian vaults.
  • An agent reads or updates notes in an existing vault.
  • An agent organizes vault files by listing and deleting them.

FAQ from OBSIDIAN-MCP-SERVER

What environment variable must I set?

You must set OBSIDIAN_VAULT_PATH to the path of your Obsidian vault.

What transport does the server use?

It uses the stdio transport.

What error codes are defined?

Common error codes include:
-32000 (general error), -32001 (vault not found), -32002 (vault already exists), -32003 (file not found), -32004 (path not found), -32005 (config file not found), -32006 (invalid config), -32007 (file operation error), -32008 (invalid request), -32009 (environment variable error), -32010 (Obsidian directory error).

Can I set a custom path when creating a vault?

Yes, the create_vault method accepts an optional path parameter.

Comments

More Memory & Knowledge MCP servers

Mcp Knowledge Graph

shaneholloman

MCP server enabling persistent memory for Claude through a local knowledge graph - fork focused on local development

871

Semantic Scholar MCP Server

YUZongmin

A FastMCP server implementation for the Semantic Scholar API, providing comprehensive access to academic paper data, author information, and citation networks.

158

Obsidian MCP Server

cyanheads

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

618

Dash Api Docs Mcp Server

Kapeli

MCP server for Dash, the macOS API documentation browser

167

Context Portal MCP (ConPort)

GreatScottyMac

Context Portal (ConPort): A memory bank MCP server building a project-specific knowledge graph to supercharge AI assistants. Enables powerful Retrieval Augmented Generation (RAG) for context-aware development in your IDE.

763