foam-notes-mcp

A local-first MCP server that exposes a [Foam](https://foambubble.github.io/foam/) markdown vault to AI agents with three retrieval layers: ripgrep-powered keyword search, a wikilink graph with PageRank and shortest-path queries, and offline semantic search via Transformers.js + sqlite-vec. Ships 16 tools + a `foam://graph` resource.

{
  "mcpServers": {
    "foam-notes-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "fbdo/foam-notes-mcp"
      ]
    }
  }
}

claude mcp add foam-notes-mcp npx -y fbdo/foam-notes-mcp

{
  "mcpServers": {
    "foam-notes-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "fbdo/foam-notes-mcp"
      ]
    }
  }
}