diff --git a/.gitignore b/.gitignore
index e10d640..6692706 100644
--- a/.gitignore
+++ b/.gitignore
@@ -15,6 +15,10 @@ Thumbs.db
 .env.local
 secrets.md
 
+# MCP Server
+node_modules/
+package-lock.json
+
 # Build artifacts
 node_modules/
 dist/
diff --git a/SETUP.md b/SETUP.md
new file mode 100644
index 0000000..02f844d
--- /dev/null
+++ b/SETUP.md
@@ -0,0 +1,135 @@
+# Second Brain + Obsidian MCP Setup Guide
+
+## Quick Start
+
+### 1. Start Obsidian
+```bash
+~/.local/bin/obsidian
+```
+Or from Applications menu if you have desktop access.
+
+### 2. Open This Vault
+- In Obsidian, click "Open folder as vault"
+- Select `/workspace/second-brain/`
+
+### 3. Install Local REST API Plugin
+1. Go to Settings → Community plugins
+2. Click "Browse" and search for "Local REST API"
+3. Install and enable it
+4. Go to the plugin settings
+5. **Copy the API Key** (you'll need this!)
+
+### 4. Configure MCP Server
+Edit `/workspace/second-brain/.env`:
+```
+OBSIDIAN_API_KEY=paste_your_api_key_here
+```
+
+### 5. Test the Setup
+```bash
+./start-mcp.sh
+```
+
+If successful, you'll see:
+```
+✅ Obsidian Local REST API is reachable
+Starting Obsidian MCP Server...
+```
+
+---
+
+## Architecture
+
+```
+┌─────────────────────────────────────┐
+│ Obsidian Desktop                    │
+│ + Local REST API Plugin             │
+│ (Port 27123)                        │
+└─────────────────────┬───────────────┘
+                      │ HTTP API
+                      ↓
+┌─────────────────────────────────────┐
+│ obsidian-mcp-server                 │
+│ (MCP Protocol)                      │
+└─────────────────────┬───────────────┘
+                      │ MCP (stdio/http)
+                      ↓
+┌─────────────────────────────────────┐
+│ AI Agent (Bumblebee/Claude)         │
+│ → Can read/write/search vault!      │
+└─────────────────────────────────────┘
+```
+
+---
+
+## Available MCP Tools
+
+Once connected, the AI agent can use:
+
+| Tool | Description |
+|------|-------------|
+| `obsidian_read_note` | Read note content and metadata |
+| `obsidian_update_note` | Append, prepend, or overwrite notes |
+| `obsidian_global_search` | Search entire vault |
+| `obsidian_list_notes` | List files in a directory |
+| `obsidian_manage_tags` | Add/remove/list tags |
+| `obsidian_manage_frontmatter` | Manage YAML frontmatter |
+| `obsidian_delete_note` | Delete a note |
+| `obsidian_search_replace` | Find and replace in notes |
+
+---
+
+## Headless Operation (Server)
+
+For running on a headless server (no display):
+
+### Option A: Virtual Display (Xvfb)
+```bash
+# Install Xvfb
+sudo apt install xvfb
+
+# Start Obsidian with virtual display
+xvfb-run -a ~/.local/bin/obsidian --no-sandbox &
+```
+
+### Option B: VNC/Remote Desktop
+```bash
+# Start a VNC server, then run Obsidian inside it
+```
+
+### Option C: X11 Forwarding
+```bash
+# SSH with X11 forwarding
+ssh -X user@server
+~/.local/bin/obsidian
+```
+
+---
+
+## Files
+
+- `.env` — API key and config (DO NOT COMMIT)
+- `start-mcp.sh` — Start the MCP server
+- `dream-sync.sh` — Nightly synthesis script
+- `.dreamrc` — Dream sync configuration
+
+---
+
+## Troubleshooting
+
+**"Cannot reach Obsidian Local REST API"**
+- Make sure Obsidian is running
+- Check that Local REST API plugin is enabled
+- Verify the port (default: 27123)
+
+**"API key invalid"**
+- Regenerate the key in Obsidian plugin settings
+- Update `.env` with new key
+
+**Obsidian won't start (headless)**
+- Use `xvfb-run` for virtual display
+- Or run with `--no-sandbox` flag
+
+---
+
+Created: 2026-04-26
diff --git a/package.json b/package.json
new file mode 100644
index 0000000..b003f16
--- /dev/null
+++ b/package.json
@@ -0,0 +1,16 @@
+{
+  "name": "second-brain",
+  "version": "1.0.0",
+  "description": "A personal knowledge base and system for capturing, organizing, and synthesizing knowledge.",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "dependencies": {
+    "obsidian-mcp-server": "^2.0.7"
+  }
+}
diff --git a/start-mcp.sh b/start-mcp.sh
new file mode 100755
index 0000000..38470d6
--- /dev/null
+++ b/start-mcp.sh
@@ -0,0 +1,43 @@
+#!/bin/bash
+# Start Obsidian MCP Server
+# Requires: Obsidian running with Local REST API plugin enabled
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$SCRIPT_DIR"
+
+# Load environment
+if [ -f .env ]; then
+  export $(grep -v '^#' .env | xargs)
+fi
+
+# Check if API key is configured
+if [ "$OBSIDIAN_API_KEY" = "YOUR_API_KEY_HERE" ] || [ -z "$OBSIDIAN_API_KEY" ]; then
+  echo "❌ OBSIDIAN_API_KEY not configured!"
+  echo ""
+  echo "To set up:"
+  echo "1. Open Obsidian"
+  echo "2. Install 'Local REST API' plugin from Community Plugins"
+  echo "3. Enable the plugin and copy the API key"
+  echo "4. Update .env with your API key"
+  exit 1
+fi
+
+# Test connection to Obsidian Local REST API
+echo "Testing connection to Obsidian Local REST API..."
+if curl -s -o /dev/null -w "%{http_code}" -H "Authorization: Bearer $OBSIDIAN_API_KEY" "$OBSIDIAN_BASE_URL/" | grep -q "200\|401"; then
+  echo "✅ Obsidian Local REST API is reachable"
+else
+  echo "❌ Cannot reach Obsidian Local REST API at $OBSIDIAN_BASE_URL"
+  echo ""
+  echo "Make sure:"
+  echo "1. Obsidian is running"
+  echo "2. Local REST API plugin is enabled"
+  echo "3. The port matches OBSIDIAN_BASE_URL in .env"
+  exit 1
+fi
+
+# Start MCP server
+echo "Starting Obsidian MCP Server..."
+exec npx obsidian-mcp-server