# Keysrs

> Keysrs is an open-source MCP server for security. Mac key vault where agents get scoped, expiring tokens and never the API keys. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI, self-hosted
- **Website:** https://keysrs.com
- **Repository:** https://github.com/gshost1/keysreallysafe
- **MCP Registry name:** io.github.gshost1/keysrs
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/keysrs
