Wrist MCP server

Gives Claude Desktop, Claude Code or any MCP client read-only access to your Wrist captures.

The iPhone app saves each capture to your Obsidian vault as a Markdown note (Settings › Obsidian, a Wrist Pro feature). This server runs on your Mac and reads those notes, so your captures don't go anywhere new. The server itself sends nothing over the network.

Requirements

• A Mac with Node.js 20 or later

• Wrist on your iPhone with Obsidian export turned on (Settings › Obsidian), and the vault synced to this Mac through iCloud Drive or Obsidian Sync

Related MCP server: obsidian-mcp

Install

git clone https://github.com/mt-atkins/wrist-mcp.git
cd wrist-mcp
npm install          # also builds dist/

Claude Code

claude mcp add wrist -- node "$PWD/dist/src/index.js" --vault "/path/to/your/vault/Wrist"

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "wrist": {
      "command": "node",
      "args": ["/path/to/wrist-mcp/dist/src/index.js", "--vault", "/path/to/your/vault/Wrist"]
    }
  }
}

An iCloud Drive Obsidian vault lives at ~/Library/Mobile Documents/iCloud~md~obsidian/Documents/<Vault>. You can also set WRIST_VAULT instead of passing --vault.

Tools

All tools are read-only and return both text and structured JSON.

Develop

npm test    # compiles and runs the parser/search tests
npx @modelcontextprotocol/inspector node dist/src/index.js --vault /path/to/Wrist

The note format is defined by ObsidianExporter.markdown(for:) in the iOS app. test/vault.test.ts pins that format, so change both together.

License

MIT. See LICENSE.