Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Gopass

FreeNot checked

Enables AI agents to securely access and manage passwords from a gopass store via four tools: list, retrieve, search, and generate passwords.

GitHubEmbed

About

Enables AI agents to securely access and manage passwords from a gopass store via four tools: list, retrieve, search, and generate passwords.

README

MCP server for gopass password management. Gives AI agents secure, on-demand access to credentials stored in your gopass (GPG-encrypted, git-backed) password store.

Prerequisites

  • Node.js >= 20
  • gopass installed and configured (v1.16+)
  • A working gopass store (run gopass ls to verify)

Install

git clone https://github.com/inavhq/gopass-mcp.git
cd gopass-mcp
npm install
npm run build

Claude Code Configuration

Add to your Claude Code MCP settings (~/.claude/settings.json or project .claude/settings.local.json):

{
  "mcpServers": {
    "gopass": {
      "command": "node",
      "args": ["/path/to/gopass-mcp/dist/index.js"]
    }
  }
}

Tools

Tool Description Write?
list_secrets List all secret paths, optionally filtered by folder prefix No
get_secret Retrieve a secret's content by path No
search_secrets Search for secrets by name No
generate_password Generate and store a random password Yes

Environment Variables

Variable Default Description
GOPASS_PATH gopass Path to gopass binary

Security

  • Uses execFile (not exec) — no shell involved, no injection surface
  • Path validation blocks directory traversal (.., absolute paths, ~)
  • Secret values are never written to stderr or logs
  • No insert_secret or delete_secret — too dangerous for LLM automation

Development

npm test          # Run tests
npm run lint      # ESLint + Prettier check
npm run typecheck # tsc --noEmit
npm run build     # Compile to dist/

License

MIT

from github.com/inavhq/gopass-mcp

Install Gopass in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install gopass-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 gopass-mcp -- npx -y github:inavhq/gopass-mcp

FAQ

Is Gopass MCP free?

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

Does Gopass need an API key?

No, Gopass runs without API keys or environment variables.

Is Gopass hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Gopass in Claude Desktop, Claude Code or Cursor?

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

Related MCPs

Compare Gopass with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All ai MCPs