Skip to main content
Glama
kirby-k-0723

Obsidian MCP Server

by kirby-k-0723
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Local

Obsidian MCP Server

Model Context Protocol (MCP) server for Obsidian vault integration. Enables AI assistants like Claude to read, write, search, and navigate your Obsidian notes.

Features

  • Note CRUD: Create, read, update, delete notes with frontmatter support

  • Search: Full-text search with tag and folder filtering

  • Graph Navigation: Explore links, backlinks, and note relationships

  • Daily Notes: Quick access to daily notes with template support

  • Resources: Expose vault notes as MCP resources

Installation

git clone https://github.com/kirby-k-0723/obsidian-mcp.git cd obsidian-mcp npm install npm run build

Configuration

Claude Code

Add to ~/.claude/settings.json:

{ "mcpServers": { "obsidian": { "command": "node", "args": ["/path/to/obsidian-mcp/dist/index.js"], "env": { "OBSIDIAN_VAULT_PATH": "/path/to/your/vault" } } } }

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{ "mcpServers": { "obsidian": { "command": "node", "args": ["/path/to/obsidian-mcp/dist/index.js"], "env": { "OBSIDIAN_VAULT_PATH": "/path/to/your/vault" } } } }

Available Tools

Tool

Description

list_notes

List all notes in vault with metadata (tags, links, backlinks)

read_note

Read note content and metadata

create_note

Create new note with optional frontmatter

update_note

Update existing note content

delete_note

Delete a note

append_to_note

Append content to existing note

search_notes

Search notes by content, with tag/folder filters

get_backlinks

Get all notes linking to a specific note

get_graph

Get note connection graph (links, backlinks, tags)

get_daily_note

Get today's or specific date's daily note

create_daily_note

Create daily note with optional template

Usage Examples

Once connected, you can ask Claude:

  • "Show me all my notes tagged with #project"

  • "Create a new note called 'Meeting Notes' with today's date"

  • "What notes link to my 'Goals 2024' note?"

  • "Search for notes mentioning 'machine learning'"

  • "Add a task to today's daily note"

Environment Variables

Variable

Description

Default

OBSIDIAN_VAULT_PATH

Path to Obsidian vault

Required

MODE

Server mode: stdio or sse

stdio

PORT

HTTP port for SSE mode

3847

Development

# Development mode with hot reload npm run dev # Build TypeScript npm run build # Run production server npm start

Project Structure

src/ index.ts # MCP server entry point, tool handlers types.ts # TypeScript type definitions vault.ts # Vault filesystem operations

License

ISC

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kirby-k-0723/obsidian-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server