docsagent-for-obsidian

DocsAgent for Obsidian 🛡️

The High-Performance Local Intelligence Layer for AI Agents.

DocsAgent for Obsidian is a professional, local-first documents intelligence engine and MCP (Model Context Protocol) server. It provides a secure, near-instant bridge between your private local files and advanced agentic platforms like Claude Desktop, Claude Code, and Cursor.

100% Local. 100% Private. Zero Data Leakage.

🔥 Why DocsAgent for Obsidian?

Modern AI Agents are incredibly smart, but they are "blind" to your private desktop documents. DocsAgent for Obsidian acts as a High-Performance Intelligence Engine that indexes your local data, allowing agents to search, read, and analyze thousands of files (1,000+) with absolute privacy.

• 🔒 Absolute Privacy: All document parsing, indexing, and vector storage happen strictly on your own hardware. Your data never leaves your machine.
• ⚡ High-Performance Core: Powered by a native C++ engine. Experience millisecond-level retrieval even across massive document libraries.
• 🔌 MCP Native: Built-in support for the Model Context Protocol (MCP), making it instantly compatible with the latest AI tools.
• 📂 Format Mastery: Native parsing for PDF, Word (.docx), PPTX.
• 🤖 Local LLM Ready: Works seamlessly with Claude 3.5/GPT-4o or run completely air-gapped with local models via Ollama.

🚀 Quick Start

1. Install via NPM

npm install -g docsagent-for-obsidian

2. CLI Usage (Local Indexing & Search)

DocsAgent for Obsidian provides a powerful CLI for managing your local knowledge base.

• Initialize your Obsidian library:

  # Link your Obsidian storage (auto-detects default path if omitted)
  da init "/Users/me/Obsidian/storage"
  

• Search your documents:

  # Perform a semantic search directly from the terminal
  da search "What are the key findings in the 2023 climate study?"
  

• Start the MCP Server:

  # Start the MCP server for AI agents (Claude, Cursor, etc.)
  da mcp
  

🔌 Agent Integration Examples

Connect DocsAgent for Obsidian to your favorite tools:

Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "docsagent-for-obsidian": {
      "command": "da",
      "args": ["mcp"]
    }
  }
}

Claude Code

Integrate with Anthropic's CLI tool:

claude code mcp add da -- da mcp

Cursor / Windsurf

• Open Settings > Features > MCP Servers.
• Click + Add New MCP Server.
• Name: DocsAgentForObsidian
• Type: command
• Command: da mcp

🛠️ Agent Tools (via MCP)

Once integrated, your AI agent gains professional-grade document capabilities through these tools:

• search: Perform deep semantic search across your entire Obsidian library to find relevant snippets.

💻 CLI Reference

DocsAgent for Obsidian provides a powerful CLI with convenient aliases (da, dag):

Command	Example	Description
init	da init	Initialize the backend index and search service
search	da search "query"	Search for documents directly from CLI
mcp	da mcp	Start the MCP server (for AI agents)
stop	da stop	Stop the background engine service

📂 Support Matrix

Format	Status	Features
PDF	✅ Full	Deep layout analysis & high-speed parsing
Word (.docx)	✅ Full	Table extraction & heading hierarchy preserved
PPTX	✅ Full	Extracts slides, shapes, and speaker notes

🤝 Community & Contributing

We are building the open standard for Local RAG. Join us in making AI respect personal data sovereignty!

• GitHub Issues: Found a bug? Have a feature request? Open an issue.
• Star the Repo: If DocsAgent for Obsidian improved your workflow, please give us a ⭐ to help others find the project!

⚖️ License

DocsAgent for Obsidian is open-source under the Apache-2.0 License.

Desktop Sovereignty is here. Empower your Agents with DocsAgent for Obsidian.