Obsidian Nexus

Obsidian Nexus is an MCP server that connects Claude Desktop directly to a local Obsidian vault for markdown note management and data organization. Knowledge workers, researchers, and families use it to interact with their personal knowledge base using natural language prompts without leaving their AI client. The server performs direct, local-only filesystem operations on markdown files, bypassing the need for third-party cloud APIs or external Obsidian plugins. Once pointed to a local directory, Obsidian Nexus provides structured tools to inspect vault status, list files across subdirectories, search text with contextual excerpts, read entire notes, append updates, and write new documents. It also offers configurable directory structures for daily notes, individual profiles, and thematic topic files. Because it works directly with standard markdown files on the user's computer, notes remain accessible through the standard Obsidian application simultaneously, preserving bidirectional links, metadata, and local file privacy while Claude Desktop automates routine documentation, updates, and searches.

Category: Files, Documents & PDFs

Tags: knowledge-management, markdown, obsidian, vault

Visit Obsidian Nexus

How to install and configure Obsidian Nexus

1. Clone the repository and install dependencies: bash git clone https://github.com/nkriman/obsidian-nexus cd obsidian-nexus npm install 2. Open config.yaml and set your absolute vault_path (for example, /Users/yourname/Documents/Obsidian/YourVault). 3. Add the server definition to your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json): json { "mcpServers": { "obsidian-nexus": { "command": "node", "args": ["/path/to/obsidian-nexus/src/index.js"] } } } 4. Restart Claude Desktop to start using the tools.

What you can do with Obsidian Nexus

• Logging daily family schedules, school updates, and extracurricular activities into structured daily markdown notes automatically. * Searching through archived medical notes and appointment records across the vault to summarize diagnoses and next steps. * Appending real-time project updates, action items, or meeting summaries directly to designated project documentation files. * Organizing disparate research notes and study materials into thematic markdown documents linked to individual topic pages. * Listing directory structures and checking vault status to verify note counts and local folder organization without manual navigation.

Key facts

• Open Source
• https://github.com/nkriman/obsidian-nexus
• Files, Documents & PDFs, Notes & Knowledge Management
• knowledge-management, markdown, obsidian, vault

Part of MCP Servers

What can Obsidian Nexus do?

Obsidian Nexus enables Model Context Protocol clients to read, write, search, and append to markdown files inside a local Obsidian vault. It provides dedicated tools such as read_note, write_note, append_to_note, list_notes, search_notes, and vault_status. It also supports automated folder creation for daily notes and specific themes.

Which MCP clients work with Obsidian Nexus?

Obsidian Nexus is designed to work with Claude Desktop by adding its Node.js execution command and file path to the client configuration file. It can also work with other MCP-compliant clients that execute local Node.js processes over standard input and output.

Does Obsidian Nexus require external plugins or API keys?

No, Obsidian Nexus does not require third-party plugins like the Obsidian Local REST API or any external API keys. It performs local file operations directly on the filesystem where your Obsidian vault resides, while Claude Desktop manages the AI processing locally.

Is Obsidian Nexus open source?

Yes, Obsidian Nexus is open-source software released under the MIT License. The full source code, documentation, and configuration options are publicly accessible in the project GitHub repository.