MCP.so
Sign In

Obsidian MCP Python

@hellozhangran

Repository

About Obsidian MCP Python

obsidian-mcp-python, a very simple MCP Server demo that can help you to operate something about your obsidian md file

#obsidian#mcp#python

Basic information

Category

Memory & Knowledge

Transports

stdio

Publisher

hellozhangran

Submitted by

Ran Zhang

Config

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

{
  "mcpServers": {
    "obsidian-mcp-python": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/of/your/project/file/obsidian-mcp-python",
        "run",
        "main.py"
      ],
      "env": {
        "OBSIDIAN_PATH": "/path/of/your/obsidian/vault"
      }
    }
  }
}

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 Python?

Obsidian MCP Python is a small demo project that helps you understand the Model Context Protocol (MCP). It enables quick setup of a real MCP service connecting to an Obsidian vault. It is intended for developers (via a tutorial) and ordinary users who want to try it.

How to use Obsidian MCP Python?

Clone the repository, install the uv tool on your local machine, then copy the provided JSON configuration into your MCP client (Cursor, Windsurf, or Claude Desktop). Adjust the directory paths and set the OBSIDIAN_PATH environment variable to point to your Obsidian vault.

Key features of Obsidian MCP Python

  • Quick setup of a real MCP service
  • Integrates with an Obsidian vault
  • Uses Python and the uv tool
  • Works with Cursor, Windsurf, and Claude Desktop
  • Includes a Tutorial.md for developers
  • Simple JSON configuration for MCP clients

Use cases of Obsidian MCP Python

  • Learning MCP by running a working example
  • Connecting an Obsidian vault to MCP clients for experimentation
  • Prototyping a personal MCP-based service
  • Demonstrating MCP setup to others
  • Testing MCP client compatibility

FAQ from Obsidian MCP Python

What is this project?

It is a small demo project designed to help you understand and set up a real MCP service.

How do I use Obsidian MCP Python?

Clone the repo, install uv, then add the provided JSON config to your MCP client, updating paths and the OBSIDIAN_PATH environment variable.

Which MCP clients are supported?

The README shows configuration examples for Cursor, Windsurf, and Claude Desktop.

Where can I find the tutorial?

Developers can look at the Tutorial.md file. Ordinary users should refer to the "Usage" section.

What environment variable is required?

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

Comments

More Memory & Knowledge MCP servers

Notion MCP Server

makenotion

Official Notion MCP Server

4.5K

Ultimate Google Docs & Drive MCP Server

a-bonus

The 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.

605

RAG Documentation MCP Server

hannesrudolph

An MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context.

267

Memory Bank MCP Server

alioshr

A Model Context Protocol (MCP) server implementation for remote memory bank management, inspired by Cline Memory Bank.

913

Notion MCP Server

awkoy

Notion MCP server for Claude, Cursor, ChatGPT & Claude Desktop. Connect AI agents to Notion via Model Context Protocol — pages, databases, blocks, comments, files.

159