About Obsidian MCP Python
Obsidian MCP Python is a small Python demo for learning how to build and run an MCP server for working with Obsidian Markdown files. It is aimed at developers exploring MCP and users trying a basic local setup.
Key features
- 01Demonstrates an MCP server in Python
- 02Provides a setup tutorial
- 03Includes client configuration guidance
Use cases
- 01Learn MCP server basics
- 02Try a local Obsidian MCP setup
MCP support
It is an MCP server demo intended to connect to clients such as Cursor, Windsurf and Claude Desktop. The README excerpt does not specify its available tools.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEobsidian-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
- clone this repo to your local pc
- install uv tool in your local pc
- 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"
}
}
}
}
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.