Advertise
MCP.so
Sign In

Obsidian MCP Python

@hellozhangran

Repository

Basic information

Category

Memory & Knowledge

Transports

stdio

Author

hellozhangran

Submitted by

Ran Zhang

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

Obsidian MCP Python 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"
      }
    }
  }
}

Obsidian MCP Python tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

What is this project?

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

2

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.

3

Which MCP clients are supported?

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

4

Where can I find the tutorial?

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

5

What environment variable is required?

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

Comments

More Memory & Knowledge MCP servers

PLUR

plur-ai

AI agents start every session with amnesia — you re-explain the project, repeat your preferences, and correct the same mistakes over and over. PLUR gives them a memory that persists. Your agent's corrections, preference

226

Memory

modelcontextprotocol

Model Context Protocol Servers

88.1K

Leviathan Systems Public Content MCP

Leviathan Systems

Search published GPU deployment, rack integration and structured cabling resources; read canonical documents and Leviathan Systems company service scope. Anonymous, read-only Streamable HTTP MCP. No credentials required.

Azquo

Azquo Holdings Ltd

Exact, shared memory for AI agents: a hierarchical database where totals always add up, every write is attributed to the agent and person behind it, and any figure traces back to its source file. Agents create databases,

Snipara

alopez3006

MCP connector for Snipara, the Project Brain for AI coding agents

1
Advertise