Gopass
FreeNot checkedEnables AI agents to securely access and manage passwords from a gopass store via four tools: list, retrieve, search, and generate passwords.
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 lsto 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(notexec) — no shell involved, no injection surface - Path validation blocks directory traversal (
.., absolute paths,~) - Secret values are never written to stderr or logs
- No
insert_secretordelete_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
Install Gopass in Claude Desktop, Claude Code & Cursor
unyly install gopass-mcpInstalls 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-mcpFAQ
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
Fetch
Web content fetching and conversion for efficient LLM usage.
AWS KB Retrieval
Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.
by modelcontextprotocolSpring AI MCP Server
Provides auto-configuration for setting up an MCP server in Spring Boot applications.
llm-analysis-assistant
A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also
by xuzexin-hzCompare Gopass with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All ai MCPs
