Skip to content
MCP server

Keysrs

Mac key vault where agents get scoped, expiring tokens and never the API keys

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, CLI, self-hosted
Runs
Locally
Version
0.16.0
Listing updated
3 days ago

About Keysrs

Keysrs is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

Keysrs is a macOS app plus a CLI and MCP server built around one rule: no tool, log or screen ever shows a key value. Agents ask for access, and each grant needs your Touch ID. A grant covers one key, one host and minutes to hours; a project token lasts 30 days, and one call revokes everything.

In practice you tell Claude Code or Codex to set up the keys for a project. The agent scans env files for credential-shaped variables (names, providers and last four characters only), then an import-and-wrap step moves the keys into the Keychain and rewrites the env file with a local gateway URL and project token. Original files are backed up outside the project, and keys unwrap restores them.

For cloud VMs and sandboxes, a token reaches the gateway on your Mac over SSH or through a relay Worker you deploy to your own Cloudflare account. The app also charts calls, tokens and estimated spend through its gateway. It is free and MIT licensed, needs macOS 14 on Apple Silicon, and the README says it sends no analytics.

Install

Run in a terminal

claude mcp add keysrs -- npx -y https://github.com/gshost1/Keysreallysafe/releases/download/v0.16.0/Keysrs.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "keysrs": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/gshost1/Keysreallysafe/releases/download/v0.16.0/Keysrs.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "keysrs": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/gshost1/Keysreallysafe/releases/download/v0.16.0/Keysrs.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "keysrs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/gshost1/Keysreallysafe/releases/download/v0.16.0/Keysrs.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "keysrs": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/gshost1/Keysreallysafe/releases/download/v0.16.0/Keysrs.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "keysrs": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/gshost1/Keysreallysafe/releases/download/v0.16.0/Keysrs.mcpb"
      ]
    }
  }
}

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

scan_project
Finds credential variables in a project's env files without exposing values.
import_and_wrap
Moves found keys into the Keychain and rewrites the env file with a project token.

What it does

Touch ID approvals
Storing a key, issuing a token or calling a provider waits for Touch ID in the app.
Scoped short-lived grants
Grants cover one key and one host for minutes to hours; project tokens last 30 days.
Key scanning
Reports variable names, providers and last-four hints from env files.
Git exposure check
Flags env files that are tracked or were ever committed.
Cloud VM relay
Remote agents hold a token while the key stays in the Mac's Keychain.
Spend charts
Shows tokens, requests and estimated spend per key and provider.

Good for

  • Move a project's .env keys into the Keychain before letting an agent loose
  • Give a script a 30-minute token for one provider
  • Run an agent on a VM without copying provider keys there
  • Revoke every grant and pairing in one call

Pricing

Open source

Free, MIT licensed

Prices change. Check keysrs.com before you buy.

Keysrs FAQ

Which agents can register it?

keys setup mcp writes an entry for Claude Code, Codex, Cursor, Droid and Claude Desktop.

What does it run on?

macOS 14 or newer on Apple Silicon; the site says Mac only for now.

Does it collect telemetry?

The README says the app sends no analytics and makes one cookieless request to GitHub's release API for update checks.

Is it paid?

No, it is free and MIT licensed.

Is Keysrs free?

Yes. Keysrs is open source, so you can use and self-host it for free.

How do I add Keysrs to Claude Code?

Run this command in your terminal: claude mcp add keysrs -- npx -y https://github.com/gshost1/Keysreallysafe/releases/download/v0.16.0/Keysrs.mcpb

What are the best alternatives to Keysrs?

The closest alternatives to Keysrs are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Keysrs

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools