Obsidian Nexus - Obsidian

Provides local Obsidian vault access via MCP for Claude Desktop, enabling read/write, search, and organization of family notes.

javascript

1

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "nkriman-obsidian-nexus": {
      "command": "node",
      "args": [
        "/path/to/obsidian-nexus/src/index.js"
      ]
    }
  }
}

Obsidian Nexus is a local MCP server that connects Claude Desktop directly to your Obsidian vault. It lets you read, write, and organize notes with natural language, while keeping all data private on your machine. You gain fast access to a structured vault, intelligent search, and a ready-made family organization system without exposing your files to external services.

How to use

You run Obsidian Nexus on your computer and connect Claude Desktop as an MCP client. Once the local server is running, you can ask Claude to read notes, create daily logs, search across your vault, and organize information by family member or theme. Use natural language queries to access and update notes, and Claude will perform the corresponding file operations in your vault.

How to install

Prerequisites: Node.js and npm must be installed on your machine.

# 1) Clone the project
git clone https://github.com/nkriman/obsidian-nexus

# 2) Install dependencies
cd obsidian-nexus
npm install

Run the server locally using the provided configuration example to ensure it starts correctly. You’ll configure your vault path in a YAML file and then wire up Claude Desktop to connect to this local server.

# Start the server (example command shown in standard usage)
node src/index.js

Configure your vault path in config.yaml and (optionally) specify family members. Then connect Claude Desktop by adding the MCP server entry shown in the next step.

Configuration and integration

Configure the Obsidian Nexus server by editing the local YAML file to point to your Obsidian vault and to optionally predefine family members. The example configuration below shows the required vault path and optional family list.

# config.yaml
vault_path: "/Users/yourname/Documents/Obsidian/YourVault"

family:
  people: ["Nick", "Sarah", "Leo", "Mia"]

Add to Claude Desktop

To connect Claude Desktop to Obsidian Nexus, add a local MCP server entry that points to the runtime script.

{
  "mcpServers": {
    "obsidian-nexus": {
      "command": "node",
      "args": ["/path/to/obsidian-nexus/src/index.js"]
    }
  }
}

Available tools

read_note

Read the contents of a specified note by path, returning the note text and metadata.

write_note

Create or update a note at a given path with the provided markdown content.

append_to_note

Append additional content to an existing note without overwriting existing text.

list_notes

List notes within a directory or across the vault, with optional filtering by directory.

search_notes

Search vault content using a query, returning matching notes with context excerpts.

vault_status

Report on the current vault configuration and basic statistics.