gopass-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gopass-mcp get the secret for aws credentials"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
gopass-mcp
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)
Related MCP server: op-mcp
Install
git clone https://github.com/inavhq/gopass-mcp.git
cd gopass-mcp
npm install
npm run buildClaude 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 all secret paths, optionally filtered by folder prefix | No |
| Retrieve a secret's content by path | No |
| Search for secrets by name | No |
| Generate and store a random password | Yes |
Environment Variables
Variable | Default | Description |
|
| Path to gopass binary |
Security
Uses
execFile(notexec) — no shell involved, no injection surfacePath 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
Available Tools
4 toolsgenerate_passwordA
Generate and store a random password at the given path in gopass
Inputs: path (required), length.
get_secretA
Retrieve a secret's content from gopass by path
Inputs: path (required).
list_secretsA
List all secret paths in the gopass store, optionally filtered by folder prefix
Inputs: prefix.
search_secretsA
Search for secrets by name in the gopass store
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: listing, retrieving, searching, and generating secrets. There is no overlap or ambiguity between them.
All tool names follow a consistent verb_noun pattern (list_secrets, get_secret, search_secrets, generate_password), making them predictable and easy to understand.
With 4 tools, the set is well-scoped for a password manager server. Each tool covers a core operation without unnecessary bloat or missing essentials.
The tool set covers the essential operations for secret management (list, get, search, generate). Missing delete_secret or update_secret, but the core workflows are solid.
Maintenance
Related MCP Connectors
Password vault for AI agents with scoped, user-approved access
Encrypted secret store and rotation for autonomous agent credentials
Give your AI hands. Identity, credential vault, and API gateway for autonomous agents.
Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.
Related MCP Servers
- FlicenseBqualityDmaintenanceEnables secure retrieval of credentials from 1Password vaults for use by AI agents, supporting integration with browser automation for automated login.1-
- FlicenseNot gradedqualityDmaintenanceEnables to manage 1Password resources including vaults, items, documents, users, groups, and more through the 1Password CLI, exposing 65 tools for comprehensive password management via natural language.-
- AlicenseNot gradedqualityBmaintenanceLocal MCP server that lets agents save copied secrets into 1Password and use approved fields through encrypted handles without plaintext secret tool arguments or responses. Includes a local permissions dashboard and optional service-account access for unattended work. Requires the 1Password CLI and runs on your computer.164 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to securely retrieve passwords, API keys, and other items from a Vaultwarden/Bitwarden vault using MCP tools with fuzzy search and caching.1MIT