Obsidian MCP Server

1# Obsidian MCP Server
2 
3<img width="1495" height="429" alt="image" src="https://github.com/user-attachments/assets/ed3f9f26-ddbd-4baf-8fce-34b44cc3c30f" />
4 
5 
6Connect Claude, ChatGPT, and other AI assistants to your Obsidian vault.
7 
8---
9 
10<div align="center">
11 
12### 💖 Support This Project
13 
14**If you find this MCP server useful, please consider supporting its development!**
15 
16[![Support via Stripe](https://img.shields.io/badge/Support-Stripe-635bff?style=for-the-badge&logo=stripe&logoColor=white)](https://buy.stripe.com/fZu8wP2n7a34fix2LKgA800)
17 
18[**👉 Click here to support this project**](https://buy.stripe.com/fZu8wP2n7a34fix2LKgA800)
19 
20*Your support helps maintain and improve this tool. Thank you!* 🙏
21 
22</div>
23 
24---
25 
26## Quick Start
27 
28### 1. Install in your AI app
29 
30**Claude Desktop:**
31Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
32```json
33{
34  "mcpServers": {
35    "obsidian": {
36      "command": "npx",
37      "args": ["-y", "@louis030195/mcp-obsidian"],
38      "env": {
39        "OBSIDIAN_API_KEY": "your-api-key-here"
40      }
41    }
42  }
43}
44```
45 
46**Claude Code:**
47```bash
48claude mcp add obsidian "npx -y @louis030195/mcp-obsidian" -s user -e OBSIDIAN_API_KEY="your-api-key-here"
49```
50 
51### 2. Enable Obsidian API (Optional - for full features)
52- Open Obsidian → Settings → Community plugins
53- Turn off Restricted mode → Search "Local REST API" → Install & Enable
54- Copy the API key and add to your config:
55  ```json
56  "env": {
57    "OBSIDIAN_API_KEY": "your-api-key-here"
58  }
59  ```
60 
61That's it! Your AI can now search and read your Obsidian notes.
62 
63## Other AI Apps
64 
65**Cursor:** Add to settings (Cmd+Shift+P → "Preferences: Open User Settings (JSON)"):
66```json
67{
68  "mcpServers": {
69    "obsidian": {
70      "command": "npx",
71      "args": ["-y", "@louis030195/mcp-obsidian"],
72      "env": {
73        "OBSIDIAN_API_KEY": "your-api-key-here"
74      }
75    }
76  }
77}
78```
79 
80## What It Can Do
81 
82- Search all your notes
83- Find notes even with typos
84- Analyze connections between notes
85- Execute Dataview queries
86- Read specific notes
87- List files and folders
88 
89## Example Questions
90 
91- "Search my notes for machine learning"
92- "Find all notes I created this week" 
93- "What meetings did I have last month?"
94- "Show me orphaned notes"
95 
96## Troubleshooting
97 
98**Obsidian not connecting?**
99- Make sure Obsidian is running
100- Check Local REST API plugin is enabled
101- Verify your API key is correct
102 
103**Need help?**
104- [GitHub Issues](https://github.com/louis030195/easy-obsidian-mcp/issues)
105- [Support this project](https://buy.stripe.com/fZu8wP2n7a34fix2LKgA800)
106 
107---
108 
109Made with ❤️ for the Obsidian community
110