# Obsidian MCP Server

An MCP server that lets Claude save conversations, notes, and structured summaries directly to your Obsidian vault.

## Features

- **Save notes** with YAML frontmatter and auto-generated backlinks
- **Daily notes** - append to today's daily note or browse past ones
- **Conversation summaries** - structured templates with decisions, code snippets, next steps
- **Vault search** - search notes by title and content
- **Auto-backlinks** - detects existing notes and inserts `[[wiki-links]]` automatically
- **Path security** - all file operations validated within vault boundary

## Installation

Requires Python 3.10+.

```bash
# Clone the repo
git clone <repo-url>
cd obsidian-mcp

# Install with uv (recommended)
uv pip install -e .

# Or with pip
pip install -e .
```

## Configuration

### Environment variable

Set `OBSIDIAN_VAULT_PATH` to your vault's root directory:

```bash
export OBSIDIAN_VAULT_PATH="$HOME/Documents/MyVault"
```

Defaults to `~/Documents/ObsidianVault` if not set.

### Claude Code

Add to your Claude Code MCP config (`~/.claude/claude_code_config.json` or project `.mcp.json`):

```json
{
  "mcpServers": {
    "obsidian": {
      "command": "obsidian-mcp",
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}
```

Or if running from source without installing:

```json
{
  "mcpServers": {
    "obsidian": {
      "command": "python",
      "args": ["/path/to/obsidian-mcp/obsidian_mcp.py"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}
```

## Tools

| Tool | Description |
|------|-------------|
| `save_note` | Create a new note with frontmatter and optional backlinks |
| `append_to_note` | Append content to an existing note |
| `append_to_daily` | Add content to today's daily note |
| `get_daily_note` | Read a daily note (today or a specific date) |
| `list_daily_notes` | List recent daily notes with previews |
| `search_vault` | Search notes by title and content |
| `list_folders` | List all folders in the vault |
| `list_tags` | Extract all tags used across the vault |
| `get_note` | Read a specific note by path |
| `save_conversation_summary` | Save a structured conversation summary with sections for decisions, code, next steps |

## Vault structure

The server creates notes in this structure:

```
YourVault/
  Claude Conversations/
    2025-01-30 - Building MCP Server.md
    ProjectName/
      2025-01-30 - Feature Work.md
  Daily Notes/
    2025-01-30.md
```