Skip to main content
Glama
Wrist MCP Server

Wrist MCP Server

by mt-atkins

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-rag-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

Tool

What it does

wrist_search_captures

Keyword search over titles, tags, summaries, to-dos and transcripts. Optional days filter.

wrist_get_capture

One capture in full: summary, to-dos, transcript, and which models transcribed and summarized it.

wrist_list_open_todos

Unticked to-dos across captures, newest first.

wrist_recent_captures

What you captured in the last N days.

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides read-only access to an Obsidian vault, enabling file listing, content reading, and text search across notes via MCP.
      4
      2
      Apache 2.0
    • F
      license
      A
      quality
      D
      maintenance
      Exposes Obsidian notes as a semantic search and RAG knowledge base over MCP, enabling AI assistants to index, retrieve, and analyze personal notes via natural language.
      7
      1
      -
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP clients to search, read, list, and append to markdown notes in a local Obsidian vault or folder of .md files.
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables natural language interaction with a local Obsidian vault, allowing MCP clients to read, search, create, append, and delete markdown notes securely.
      7
      MIT