hermeer-mcp-server

MCP server for Hermeer — connects Claude Desktop to your practice data.

Hermeer is an iOS app for tracking tarot pulls, dreams, therapy sessions, journal entries, synchronicities, and astrological transits. This MCP server lets Claude Desktop read your synced data and write depth interpretations back — they appear in the app automatically.

Install

npm install -g hermeer-mcp-server

Requires Node.js 18+.

Configure Claude Desktop

Add this to your Claude Desktop config file:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hermeer": {
      "command": "hermeer-mcp-server"
    }
  }
}

The server automatically finds your HermeerSync folder. To override the location:

{
  "mcpServers": {
    "hermeer": {
      "command": "hermeer-mcp-server",
      "env": {
        "HERMEER_BASE": "/path/to/your/HermeerSync"
      }
    }
  }
}

Common sync folder locations:

• Mac + iCloud: ~/Library/Mobile Documents/com~apple~CloudDocs/HermeerSync/
• Mac + OneDrive: ~/Library/CloudStorage/OneDrive-Personal/HermeerSync/
• Windows + iCloud: C:\Users\{name}\iCloudDrive\HermeerSync\
• Windows + OneDrive: C:\Users\{name}\OneDrive\HermeerSync\
• Windows + Google Drive: G:\My Drive\HermeerSync\
• Encrypted setup: ~/.hermeer-local/ (with decrypt daemon running)

Restart Claude Desktop after saving the config.

Set up your Depth Work project

1. In Claude Desktop: Projects > Create Project and name it "Depth Work"
2. Click the project, then Set project instructions
3. Paste the companion template from the Hermeer app (Settings > Depth Companion > Copy Project Instructions)
4. Open a chat and say: "Read my current state and tell me what's alive."

Claude reads your data through the MCP server and writes interpretations back to your sync folder. Open Hermeer and they appear on your entries.

Tools

Read (11 tools)

Write (7 tools)

All writes use atomic file operations (write to temp, then rename) to prevent sync from picking up partial files.

With encryption

If you've enabled encryption in the Hermeer app, synced files are .hermeer.enc (AES-256-GCM). The MCP server reads plaintext — it doesn't handle encryption directly. Instead:

1. Run the decrypt daemon on your computer (see Hermeer app > Settings > Encrypt Synced Files)
2. The daemon decrypts files to ~/.hermeer-local/
3. Set HERMEER_BASE to ~/.hermeer-local/ in your Claude Desktop config
4. The daemon encrypts interpretations written by the MCP server back to the cloud folder

Development

git clone https://github.com/hermeerapp/hermeer-mcp-server
cd hermeer-mcp-server
npm install
npm run build

To test locally without installing globally:

node dist/index.js

License

MIT