becki-mcp

Becki Core — cross-platform memory layer for AI tools.

A Model Context Protocol (MCP) server that gives Claude, Cursor, Codex, ChatGPT, and any MCP-compatible client persistent, structured memory across every session, project, and machine.

• 🧠 Structured memory — decisions, commitments, asks, dead-ends, open loops (not just notes)
• 🔄 AI session bootstrap — auto-indexes your existing Claude Code / Codex / Cursor history
• 📁 Project sweeper — watches your repos, extracts intent from git activity
• 🌍 Cross-platform — Windows, macOS, Linux
• 🔐 Auth-scoped — per-install token, server-issued, revocable from the dashboard

Requires a paid Becki subscription. Sign up at becki.io/account ($15/month, monthly billing).

Install

npm install -g becki-mcp

Requires Node.js 20+. Works on Windows, macOS, and Linux.

Setup

Generate an install token at becki.io/account, then:

becki-mcp init

This will:

1. Scan common project directories (~/Documents, ~/Repos, ~/Code, ~/src, ~/Projects, ~/Developer) for git repos
2. Prompt to register them as Becki projects
3. Print the MCP config snippet to paste into your AI client

Add custom scan paths with --scan <path> (repeatable) or auto-confirm everything with --yes.

Configure your AI client

After becki-mcp init, add the printed snippet to your AI client's MCP config:

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "becki": {
      "command": "becki-mcp"
    }
  }
}

Cursor / Windsurf / Codex CLI / Zed — same structure, under mcpServers.

Restart your AI client. The becki_* tools will appear.

Backfill your AI session history

To ingest the last 90 days of Claude Code / Codex CLI / Cursor sessions:

becki-mcp bootstrap

Or specify a custom window:

becki-mcp bootstrap 30    # last 30 days

Bootstrap is idempotent — files already processed are tracked in the local SQLite cache and skipped on re-run.

Daily digest

A background daily digest runs automatically when the MCP server is invoked by your AI client (it kicks off after the first request and re-runs every 12h). You can also run it manually:

becki-mcp digest

Local files

becki-mcp stores configuration and a local cache at:

• Default: ~/.becki/ (Windows: %USERPROFILE%\.becki\)
• Mac with Becki Studio installed: ~/Library/Application Support/Becki/ (shared with the Mac app)
• Override: set the BECKI_HOME env variable

The cache (cache.db) is a SQLite file holding:

• Project registrations
• AI session index (paths + last-processed sizes for idempotency)
• Recent vault rows for fast MCP reads
• Daily digest state

No audio, no transcripts, no model weights. Footprint typically 10–100 MB depending on AI history depth.

Commands

| Command | What it does | |---|---| | becki-mcp | Run MCP stdio server (used by AI clients — your normal config target) | | becki-mcp init | First-time setup; register projects + print MCP config snippet | | becki-mcp digest | Run today's session-digest sweep right now | | becki-mcp bootstrap [N] | Historical ingest of AI session logs (default 90 days) | | becki-mcp --help | Show usage |

Privacy

• Your install token authenticates only to the Becki backend (Supabase) — no third parties.
• All ingested content goes to your private vault. Per-user row-level security enforced at the database level.
• AI session logs are read locally — only extracted entities (decisions / commitments / asks / dead-ends) are sent to the backend, never raw transcripts.
• Becki uses Anthropic Haiku for extraction and Voyage AI for embeddings. Both are on no-train policies — your data is never used for model training.

Becki Studio (Mac users)

If you want meeting capture (on-device transcription), the native Mac app with the NeuraVault 3D graph, and the full visual interface, upgrade to Becki Studio ($25/month). Studio bundles becki-mcp, so you don't need to install it separately.

Support

• Docs: https://www.becki.io
• Issues: https://github.com/bdsantosDEV/becki-vault/issues
• Email: [email protected]

License

Copyright © 2026 BECKI.IO LLC. All rights reserved. Use of this package is governed by the Becki Terms of Service and a valid paid subscription. See LICENSE for distribution terms.