Log inSubmit server
Enquire MCP logo

Enquire MCP

by oomkapwn

Connects MCP-compatible agents to a local Obsidian vault for cited, freshness-aware Markdown and PDF retrieval.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Enquire MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "oomkapwn-enquire-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@oomkapwn/enquire-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

oomkapwn/enquire-mcp turns a local Obsidian vault into a queryable memory source for MCP-compatible agents. It indexes Markdown and PDFs, including OCR text, then combines lexical and embedding retrieval with optional BGE reranking and freshness metadata. Structured tools cover Canvas files, supported Dataview LIST/TABLE queries, and supported Obsidian Base filters. Reach for it when agents need portable, source-cited knowledge shared across tools without outbound calls initiated by the server.

Use cases

  • Search an Obsidian vault for cited project history
  • Retrieve PDF passages with page references
  • Check whether stored notes are stale
  • Run structured Canvas, Dataview, or Base queries
  • Share one local knowledge source across agents

Key features

  • Hybrid Markdown and PDF retrieval
  • OCR for scanned PDF pages
  • Freshness and source citation metadata
  • BGE reranking with HNSW and int8 indexing
  • Canvas, Dataview, and Obsidian Base tools
  • Read-only mode with an explicit write gate

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

19/20 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 12d ago via OSV.dev · @oomkapwn/enquire-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars34Stargazers on the source repository.
npm downloads1.9kPackage downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Directory activity10 viewsConfig copies, upvotes, and views on AllMCPs.

How Enquire MCP works

What oomkapwn/enquire-mcp does

oomkapwn/enquire-mcp exposes an Obsidian vault through the Model Context Protocol so agents can search and inspect knowledge stored in files they already maintain. Markdown notes, frontmatter, wikilinks, PDFs, and OCR-derived text can participate in retrieval. Results preserve source paths, and PDF matches retain page references for citation. Search responses can also include document age and a stale indicator, helping an agent decide when to verify older material.

The server is designed for shared, vendor-neutral agent memory. The source files remain ordinary, editable Obsidian files rather than being moved into a proprietary conversation-memory store. Claude Code, Claude Desktop, Cursor, ChatGPT, Codex, OpenClaw, and other MCP-compatible agents can use the same vault through their MCP connections.

How it works

At serving time, the vault is indexed locally. Retrieval combines lexical matching with machine-learning embeddings, then can apply a BGE cross-encoder reranker. Reciprocal rank fusion combines signals, while HNSW indexing and int8 quantization support the dense retrieval path. Optional recency weighting can favor newer notes, and agent-oriented retrieval includes HyDE and bounded sub-question generation.

The system also adds a lightweight graph dimension by detecting wikilink communities with Louvain clustering. Search output can expose per-signal scores and stage information, which gives agents more context about why a result was selected. PDFs follow the same local retrieval path as Markdown, with Tesseract OCR available for scanned pages.

Setup and configuration

Install the published npm package globally:

Terminal
npm i -g @oomkapwn/enquire-mcp

Start the server by supplying the vault path:

Terminal
npx -y @oomkapwn/enquire-mcp serve --vault /path/to/Obsidian-Vault

Claude Code can register the same command with its MCP configuration:

Terminal
claude mcp add obsidian -- npx -y @oomkapwn/enquire-mcp serve --vault /path/to/Obsidian-Vault

The vault location is passed through the --vault command-line option. Published GitHub releases and published npm versions are the appropriate sources for usable artifacts.

Tools and capabilities

  • Search Markdown and PDF content with hybrid lexical and semantic retrieval.
  • Preserve note paths, PDF page citations, age metadata, and stale status in search results.
  • Parse Obsidian Canvas files as typed graph data.
  • Run the supported Dataview-style LIST and TABLE query subset.
  • Execute supported Obsidian Base filters.
  • Use OCR to retrieve text from scanned PDF pages.
  • Apply optional BGE reranking, recency weighting, HyDE, and sub-question retrieval.
  • Inspect retrieval signals and stage-level scoring details.

Limitations and notes

The server is read-only by default. Write tools become available only when it is started with --enable-write, so deployments that need mutation should enable that capability deliberately. Dataview and Obsidian Base support covers documented subsets rather than every feature of those systems.

Processing is local during serving, and enquire-mcp initiates no outbound calls or telemetry. Any later handling of returned context depends on the MCP client and model connected to it. The project is distributed under the MIT license.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Enquire MCP

oomkapwn/enquire-mcp is an MCP server that connects AI agents to a local Obsidian vault, indexing Markdown and PDFs/OCR for cited hybrid search. Its tools also parse Canvas files, run supported Dataview LIST/TABLE queries, execute supported Obsidian Base filters, and expose freshness metadata such as age and staleness.

Install it with `npm i -g @oomkapwn/enquire-mcp`, then start it with `npx -y @oomkapwn/enquire-mcp serve --vault /path/to/Obsidian-Vault`. Claude Code can register that command with `claude mcp add`.

Yes, Cursor is listed as a supported client. Configure Cursor to launch the MCP server with the `serve --vault` command and the path to the local Obsidian vault.

Yes, it starts in read-only mode. Write tools are exposed only when the server is launched with `--enable-write`, allowing deployments to keep mutation disabled unless it is explicitly needed.

Related MCP servers

All in Knowledge & Memory All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewEnquire MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/oomkapwn-enquire-mcp?style=directory)](https://allmcps.com/mcp/oomkapwn-enquire-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/oomkapwn-enquire-mcp"><img src="https://allmcps.com/api/badge/oomkapwn-enquire-mcp?style=directory" alt="Enquire MCP on AllMCPs" /></a>