Command Palette

Search for a command to run...

UnylyUnyly
Browse all

@Secr/

FreeMaintained

Provides AI coding agents with direct access to secrets management (get, set, list, delete secrets, and list environments) through the Model Context Protocol, e

GitHubEmbed

About

Provides AI coding agents with direct access to secrets management (get, set, list, delete secrets, and list environments) through the Model Context Protocol, enabling secure secret operations during development.

README

Secr MCP server — gives AI coding agents (Claude Code, Cursor, Copilot) direct access to secrets via the Model Context Protocol.

Install

npm install @secr/mcp

Setup

Claude Code

claude mcp add secr -e SECR_TOKEN=secr_agent_xxx -- npx @secr/mcp

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "secr": {
      "command": "npx",
      "args": ["@secr/mcp"],
      "env": { "SECR_TOKEN": "secr_agent_xxx" }
    }
  }
}

VS Code (Copilot)

Add to .vscode/mcp.json:

{
  "servers": {
    "secr": {
      "command": "npx",
      "args": ["@secr/mcp"],
      "env": { "SECR_TOKEN": "secr_agent_xxx" }
    }
  }
}

Tools

The server exposes 5 tools to AI agents:

Tool Description
get_secret Get a single secret value by key
list_secrets List secret key names (no values) with optional search
set_secret Create or update a secret
delete_secret Delete a secret
list_environments List environments for a project

All tools accept optional org, project, and environment parameters. When omitted, they resolve from environment variables or .secr.json.

Environment Variables

Variable Required Default Description
SECR_TOKEN Yes -- Agent token (secr_agent_...)
SECR_ORG No .secr.json Organization slug
SECR_PROJECT No .secr.json Project slug
SECR_ENVIRONMENT No .secr.json Default environment slug
SECR_API_URL No https://api.secr.dev API base URL

Creating an Agent Token

secr agents create --name "claude-code" --scope "read:secrets,write:secrets"

Agent tokens use scoped permissions — the server only has access to what the token allows.

Documentation

Full docs at secr.dev/docs.

License

MIT

from github.com/secr-dev/mcp

Install @Secr/ in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install secr-mcp

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add secr-mcp --env SECR_TOKEN="" -- npx -y @secr/mcp

Step-by-step: how to install @Secr/

FAQ

Is @Secr/ MCP free?

Yes, @Secr/ MCP is free — one-click install via Unyly at no cost.

Does @Secr/ need an API key?

Yes, it requires environment variables: SECR_TOKEN. Unyly injects them into the config during install.

Is @Secr/ hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install @Secr/ in Claude Desktop, Claude Code or Cursor?

Open @Secr/ on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Changes

Versions and requested access over time.

  • New version published
  • New version published

Related MCPs

Compare @Secr/ with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All ai MCPs