mcpField
O
Obsidian MCP Lite

Obsidian MCP Lite

Local
github.com/yokarilightMemory & Knowledge1Updated 78w ago
Repository

About Obsidian MCP Lite

Obsidian MCP Lite is a TypeScript MCP server for interacting with Obsidian vaults. It supports file browsing, text search, and vault content edits through Obsidian's Local REST API.

Key features

  1. 01List vault and directory files
  2. 02Read file contents
  3. 03Search text in files
  4. 04Patch or append content
  5. 05Delete files

Use cases

  1. 01Browse files in an Obsidian vault
  2. 02Find text across vault files
  3. 03Update or append notes
  4. 04Remove vault files

MCP support

Exposes vault file listing, reading, searching, editing, and deletion capabilities to MCP clients, using the Obsidian Local REST API.

#obsidian#mcp#typescript

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "obsidian-map-lite": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
Run commandnpx -y @modelcontextprotocol/inspector

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@modelcontextprotocol/inspector

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Obsidian MCP Lite

A TypeScript-based MCP server for Obsidian, providing a simple interface to interact with Obsidian vaults.

Features

  • List files in vault
  • List files in directory
  • Get file contents
  • Search specific texts from files
  • Patch content
  • Append content
  • Delete files

Prerequisites

  • Node.js >= 18.16.0
  • Obsidian with Local REST API plugin installed
  • Obsidian API key

Setup

# Install dependencies
pnpm install

# Build server
pnpm run build

Configuration

  1. Copy .env.example to .env:

    cp .env.example .env

  2. Edit .env and set your Obsidian API key and host:

    OBSIDIAN_API_KEY=your-api-key-here
OBSIDIAN_HOST=http://localhost:27123

Installation

To use with Cursor, add the following config:

{
  "mcpServers": {
    "obsidian-mcp-lite": {
      "command": "node",
      "args": [
        "/path/to/obsidian-mcp-lite/dist/index.js"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Debugging

Use the MCP Inspector:

npx @modelcontextprotocol/inspector -e OBSIDIAN_API_KEY=your-api-key-here node dist/index.js"

You will find a URL provided in the terminal. Open it and access to the debugging tool in the browser.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.