Skip to main content
Glama

okf-wiki-mcp

Zero-dependency, 100% offline Model Context Protocol (MCP JSON-RPC 2.0) stdio server and CLI for querying local Google OKF v0.2 and Obsidian Markdown meeting-notes vaults inside Claude Desktop, Claude Code, Cursor, Windsurf, and OneMira.

  • Zero npm runtime dependencies — pure Node.js >=18 standard library (node:fs, node:path), auditable in under 350 lines.

  • 100% Local & Zero Cloud — reads .md transcripts, YAML frontmatter, [[wiki-links]], and - [ ] action items directly from disk with zero external network calls.

  • Works with any local Markdown vault — Obsidian vaults, transcripts migrated via transcript-to-okf from Otter/Plaud/HiNotes/Notta, or live spoken context captured by the OneMira C1 AI Voice Recorder ($0/mo Local AI · Works Standalone · Speaker ID · Zero Cloud).


Install & Run Instantly

Via npx (Zero Global Install)

npx github:onemira-space/okf-wiki-mcp --vault ~/Documents/Meetings stats

Via Homebrew (macOS & Linux)

brew tap onemira-space/tap https://github.com/onemira-space/homebrew-tap
brew install okf-wiki-mcp
okf-wiki-mcp --vault ~/Documents/Meetings stats

Related MCP server: ai-lab

Connect to Claude Desktop, Claude Code & Cursor (mcpServers)

Add to claude_desktop_config.json or .cursor/mcp.json:

{
  "mcpServers": {
    "okf-wiki": {
      "command": "npx",
      "args": ["-y", "github:onemira-space/okf-wiki-mcp", "--vault", "/Users/you/Documents/Meetings", "--serve"]
    }
  }
}

Provided MCP Tools (tools/list)

Tool

Description

okf_search_meetings

Search .md transcripts and notes by keyword, speaker, tag, and ISO fromDate/toDate.

okf_list_action_items

Extract - [ ] / - [x] action items across all sessions filtered by status and @owner.

okf_read_note

Read a note by relative path, slug, or [[wiki-link]] title, including frontmatter and incoming backlinks.

okf_topic_graph

Compute the relational [[wiki-link]] graph, top referenced entities, and unresolved links.

okf_vault_stats

Audit total notes, YAML frontmatter coverage, unique speakers, and action-item completion counts.


Companion Open-Source Local Context Tools

License

MIT © OneMira

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
      A
      maintenance
      Enables local semantic search over documents and code for Claude Code and Claude Desktop, running entirely offline with local embeddings and vector storage.
      14
      886 PyPI
      7
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables local hybrid search over Obsidian and Markdown vaults via MCP, combining vector retrieval, full-text search, reranking, graph navigation, and safe CRUD while keeping data local.
      43
      1
      MIT
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI agents and MCP hosts to query a local, machine-resident index of scattered notes, project docs, PDFs, Office files, and chat exports using hybrid vector + BM25 retrieval with section-level citations. Exposes tools, resources, and prompts so hosts like Claude Desktop, Cursor, and Cline can search, ask, and explore linked knowledge through natural language.
      -