Obsidian MCP Python

@hellozhangran

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

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.

Frequently asked questions

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

Basic information

More Memory & Knowledge MCP servers

MCP Apple Notes

RafalWilinski

Talk with your notes in Claude. RAG over your Apple Notes using Model Context Protocol.

401

MemoryMesh

CheMiguel23

A knowledge graph server that uses the Model Context Protocol (MCP) to provide structured memory persistence for AI models.

348

Groundwork

Rarefied-Earth

Groundwork: company memory for your AI tools. Docs public. Source closed. Public proof needs no account.

Notion MCP Integration

danhilse

A simple MCP integration that allows Claude to read and manage a personal Notion todo list

208

Anytype MCP Server

anyproto

An MCP server enabling AI assistants to interact with Anytype - your encrypted, local and collaborative wiki - to organize objects, lists, and more through natural language.

467