Skip to main content
Glama
sdntsng

Sutrana

by sdntsng
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Local

Sutrana

Local-first ambient memory for Mac: continuously captures what you see, indexes it on-device, exposes it as an MCP server for Claude/Cursor, and surfaces open loops in a Shram-style menu-bar inbox.

CI License: MIT

Status: Early public preview (v0.1). Capture → SQLite/FTS → MCP → menu-bar open tasks works on Apple Silicon with full Xcode. Not a signed App Store build yet.

What it does

  • Menu bar app — open tasks stream, settings, permissions, kill switch

  • Screen capture + OCR — ScreenCaptureKit + Vision, local SQLite + FTS5

  • MCP tools — search_memory, get_timeline, list_open_tasks, suggest_followups, list_day_summaries, embed_recent_memory

  • Optional hybrid search — local Ollama embeddings (off until you run Ollama)

All data lives under ~/Library/Application Support/Sutrana/. No cloud by default.

Related MCP server: Memex

Quick start

1. Memory + MCP (Node)

git clone https://github.com/sdntsng/sutrana.git
cd sutrana
npm install
npm run build
npm run mcp

2. Mac menu bar app

Requires full Xcode (Command Line Tools alone are not enough).

cd apps/mac
./Scripts/build-app.sh
open Sutrana.app

Grant Screen Recording (and optionally Accessibility) when prompted — or use the Permissions tab.

3. Connect Claude Desktop / Cursor

See docs/claude-desktop.md and docs/cursor.md.

Privacy

  • Local-only storage and embeddings by default

  • Private-apps denylist in Settings

  • Pause capture anytime from the menu bar

  • Microphone / accessibility scrapers are opt-in later; mic is not used in v0

See SECURITY.md to report issues.

Repo layout

apps/mac/           Swift menu-bar capture agent
packages/memory/    SQLite FTS + open tasks + day summaries + Ollama embeddings
packages/mcp/       MCP stdio server
docs/               client config examples

Development

  • Default contribution branch: dev (staging)

  • main is production / releases

  • npm run build · npm run typecheck · npm test

See CONTRIBUTING.md.

Roadmap (post-v0.1)

  • Signed .dmg distribution

  • Stronger open-task heuristics / LLM drafts

  • Accessibility messaging scrapers (opt-in)

  • Optional remote embeddings with explicit consent

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Memex

    arnavbee
    A
    license
    A
    quality
    B
    maintenance
    A local-first, privacy-first MCP server that passively indexes personal digital activity (screenshots, clipboard, notes, downloads, links) into a local database, enabling LLMs like Claude to access your context without cloud storage.
    4
    MIT

  • KIAgent

    edjafarov
    A
    license
    Not graded
    quality
    A
    maintenance
    Personal digital memory: a desktop app that indexes your mail, chats, and documents into a local SQLite corpus on your machine — parsing and OCR run on-device via llama.cpp — and serves them to any MCP client. Local server on 127.0.0.1, plus an optional per-user remote endpoint (you.localkiagent.com) whose TLS terminates on your own device.
    7
    MIT

  • shyn

    shyn-labs
    F
    license
    Not graded
    quality
    B
    maintenance
    Enables AI assistants to search and retrieve memories from your Mac, including screen captures, meeting transcripts, and browsing history, all locally and privately.
    1
    -