Hook

--- links: "[[Ideaverse/AI/Hook/Hook|Hook]]" ---

MCP server that gives Claude Code (and other MCP clients) full access to Hookmark — the macOS app that creates bidirectional links between files, URLs, emails, notes, and anything else with an address.

Link a PDF to an email. Connect a note to a webpage. Find everything related to a project. All through natural language.

Claude Code  ──MCP──▶  hookmark-mcp  ──shell──▶  hook CLI  ──▶  Hookmark.app
                        (this server)              (v2.1.3)       (macOS)

The server wraps Hookmark's hook CLI as seven MCP tools. Claude calls them like any other tool — you just talk normally:

• *"Link my TODO to that PDF on the desktop"*
• *"What's connected to this file?"*
• *"Search hookmark for everything about invoices"*
• *"Hook whatever's open in Mail to this project"*

You never need to remember tool names or parameters.

Prerequisites:

• macOS with Hookmark installed
• Hookmark's hook CLI (gem install hookmark or installed with Hookmark)
• Node.js 18+ or Bun

Install with Claude Code:

Tell Claude:

> *"Install the hookmark MCP server from github.com/mnott/Hook"*

Claude will clone the repo, build it, and add it to your MCP config.

Manual install:

Add to your Claude Code MCP config (~/.claude.json):

{
  "mcpServers": {
    "hookmark": {
      "command": "npx",
      "args": ["-y", "hookmark-mcp"]
    }
  }
}

Or with Bun:

{
  "mcpServers": {
    "hookmark": {
      "command": "bunx",
      "args": ["hookmark-mcp"]
    }
  }
}

Restart Claude Code. The tools are ready.

From source (development):

git clone https://github.com/mnott/Hook.git
cd Hook
bun install
bun run build

Then point your MCP config to the local build:

{
  "mcpServers": {
    "hookmark": {
      "command": "node",
      "args": ["/path/to/Hook/dist/ind