mcp-obsidian  by smithery-ai

Connector for Claude Desktop to read and search an Obsidian vault

created 8 months ago
1,037 stars

Top 36.8% on sourcepulse

GitHubView on GitHub
Project Summary

This project provides a connector for Claude Desktop, enabling it to read and search directories containing Markdown notes, such as Obsidian vaults. It targets users of Claude Desktop and Obsidian who want to integrate their knowledge base with an AI assistant for enhanced context and search capabilities.

How It Works

The connector leverages the Model Context Protocol (MCP) to interface with Claude Desktop. It takes a path to an Obsidian vault as input and makes the Markdown files within that directory accessible to the MCP client. This allows the AI to query and retrieve information directly from the user's personal knowledge base.

Quick Start & Requirements

  • Installation: npx @smithery/cli install mcp-obsidian --client claude
  • Prerequisites: Claude Desktop, npm.
  • Usage: Restart Claude Desktop after installation to see the MCP tools. For VS Code integration, add a JSON configuration block to user settings or a .vscode/mcp.json file.
  • Documentation: https://github.com/smithery-ai/mcp-obsidian

Highlighted Details

  • Enables AI access to local Markdown knowledge bases.
  • Integrates with Claude Desktop via the Model Context Protocol.
  • Supports VS Code integration for workspace-specific configurations.

Maintenance & Community

No specific details on contributors, sponsorships, or community channels are provided in the README.

Licensing & Compatibility

The license is not specified in the README.

Limitations & Caveats

The README does not specify the license, which may impact commercial use or closed-source integration. Further details on supported Markdown features or potential performance limitations with very large vaults are not provided.

Health Check
Last commit

3 weeks ago

Responsiveness

1 day

Pull Requests (30d)
1
Issues (30d)
0
Star History
254 stars in the last 90 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems), Eugene Yan Eugene Yan(AI Scientist at AWS), and
1 more.

obsidian-copilot by eugeneyan

0.4%
542
Prototype assistant for writing and thinking
created 2 years ago
updated 1 year ago
Starred by Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems), Travis Fischer Travis Fischer(Founder of Agentic), and
1 more.

fastmcp by punkpeye

3.7%
2k
TypeScript framework for building MCP servers handling client sessions
created 7 months ago
updated 2 days ago
Feedback? Help us improve.