Repository avatar
Other Tools
v1.0.2
active

okf-wiki-mcp

io.github.onemira-space/okf-wiki-mcp

Offline zero-dependency MCP server for local Google OKF v0.2 & Obsidian Markdown vaults.

Documentation

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 -y 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

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", "okf-wiki-mcp", "--vault", "/Users/you/Documents/Meetings", "--serve"]
    }
  }
}

Provided MCP Tools (tools/list)

ToolDescription
okf_search_meetingsSearch .md transcripts and notes by keyword, speaker, tag, and ISO fromDate/toDate.
okf_list_action_itemsExtract - [ ] / - [x] action items across all sessions filtered by status and @owner.
okf_read_noteRead a note by relative path, slug, or [[wiki-link]] title, including frontmatter and incoming backlinks.
okf_topic_graphCompute the relational [[wiki-link]] graph, top referenced entities, and unresolved links.
okf_vault_statsAudit total notes, YAML frontmatter coverage, unique speakers, and action-item completion counts.

Companion Open-Source Local Context Tools

License

MIT © OneMira

NPM
okf-wiki-mcp
Install Command
npm install okf-wiki-mcp