jarvis-mcp-server

A personal MCP server for your Obsidian vault, SQLite database, and filesystem — accessible from any Claude client, anywhere.

What it does

Runs on your home server and exposes a set of tools to Claude via the Model Context Protocol. Claude on any device — mobile, web, desktop — can read and write your Obsidian vault, query a local SQLite database, and manage files, all authenticated via OAuth 2.1 over Tailscale.

Related MCP server: Obsidian MCP Server

Architecture

Claude (any device)
        │
        │  HTTPS + OAuth 2.1
        ▼
Tailscale Funnel  ──►  jarvis-mcp-server :3701
                              │
                 ┌────────────┼────────────┐
                 ▼            ▼            ▼
        Obsidian REST    SQLite DB    Filesystem
          :27123        data/jarvis   (allowlist)

Tools

📓 Obsidian Vault

🤖 Jarvis Workflows

🗄️ SQLite Database

📁 Filesystem

Security: All filesystem operations are restricted to directories listed in FS_ALLOWED_PATHS in src/constants.ts. Paths outside this allowlist are rejected before any I/O runs.

Requirements

• Node.js ≥ 18

• Obsidian with the Local REST API plugin installed

• Tailscale with Funnel enabled

• A machine that stays on (home server, mini PC, etc.)

Setup

1. Install

git clone https://github.com/your-username/jarvis-mcp-server.git
cd jarvis-mcp-server
npm install
cp .env.example .env

2. Configure .env

3. Set allowed filesystem paths

Edit src/constants.ts and update FS_ALLOWED_PATHS to the directories you want Claude to have access to.

4. Build

npm run build

5. Expose via Tailscale Funnel

tailscale funnel --bg 3701

6. Run (production)

npm install -g pm2
pm2 start dist/index.js --name jarvis-mcp
pm2 save

PM2 is a process manager for Node.js. It keeps your server running in the background without a terminal window open, automatically restarts it if it crashes, and lets you check its status at any time with pm2 status.

Why not just npm start? Running npm start directly ties the server to your terminal session — close the window and the server dies. PM2 runs it as a background daemon that survives terminal closures.

⚙️ Optional: Auto-start on Windows boot

By default PM2 itself doesn't survive a reboot on Windows. To fix that, this repo includes pm2-start.bat — a one-line script that tells PM2 to restore your saved process list:

pm2 resurrect

To make the server start automatically every time Windows boots:

1. Press Win + R, type taskschd.msc, press Enter

2. Click Create Basic Task

3. Name: jarvis-mcp-server (or anything you like)

4. Trigger: When the computer starts

5. Action: Start a program → browse to pm2-start.bat in this repo

6. Finish

Now the server comes back online automatically after every reboot — no manual intervention needed.

7. Connect Claude

Settings → Connectors → Add connector → enter your Tailscale URL + /mcp

Use OAUTH_CLIENT_ID and OAUTH_CLIENT_SECRET from your .env when prompted.

Connector icon: Claude uses Google's favicon service to display connector icons. Since this server runs on a Tailscale domain (*.ts.net) that Google can't reach, the connector will show a generic placeholder icon. This is cosmetic only — everything works normally. A custom icon would require pointing a public domain at your server.

Development

npm run dev      # watch mode — recompiles on save
npm run build    # production build
npm run clean    # remove dist/

Adding tools

Each domain has its own file:

src/
├── schemas/      ← Zod input schemas (entrance guards)
├── services/     ← Workers (ObsidianClient, SQLite connection)
├── tools/        ← Tool registrations (vault, sqlite, filesystem, jarvis)
└── utils/        ← Shared helpers (path safety)

To add a new tool: define its schema in schemas/, implement it in tools/, register it in buildServer() in index.ts.

Version history