Skip to content

fbdo/foam-notes-mcp

Repository files navigation

foam-notes-mcp

Local-first MCP server for Foam-style Markdown vaults. Provides keyword, graph, semantic, and hybrid search over wikilinks, backlinks, frontmatter, tags, and tasks.

Status: in development.

See docs/PLAN.md for the authoritative plan, tool inventory, architecture, and waves checklist. Full user-facing README lands in Wave 7.

Platform

macOS and Linux only (Windows rejected at startup).

License

MIT © Fabio Lopes

About

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.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors