MCP ExplorerExplorer

Obsidian Mcp Python

@hellozhangranon 10 months ago
2 MIT
FreeCommunity
AI Systems
obsidian-mcp-python, a very simple MCP Server demo that can help you to operate something about your obsidian md file

Overview

What is Obsidian Mcp Python

obsidian-mcp-python is a simple demo project designed to help users understand and set up a real MCP Server that interacts with Obsidian markdown files.

Use cases

Use cases include automating tasks related to Obsidian files, integrating with other applications, and providing a demo environment for developers to learn about MCP.

How to use

To use obsidian-mcp-python, clone the repository to your local machine, install the uv tool, and configure your MCP Client with the provided JSON configuration, specifying the path to your project and Obsidian vault.

Key features

Key features include easy setup for MCP services, integration with Obsidian markdown files, and a straightforward configuration process for users.

Where to use

obsidian-mcp-python can be used in personal knowledge management, note-taking applications, and any scenario where users want to enhance their workflow with Obsidian.

Content

obsidian-mcp-python

notice

Actually, this is a small demo project designed to help you understand MCP. It enables you to quickly get to know and set up a real MCP service.

  • If you’re a developer, you can look at the Tutorial.md
  • If you’re an ordinary user who just wants to have a try, please refer to the “Usage” section.

Usage

  1. clone this repo to your local pc
  2. install uv tool in your local pc
  3. copy bellow json config into you MCP Client (Cursor/Windsurf/Claude Desktop)
{
  "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

Comments

Recommend MCP Servers

View All MCP Servers