Unix pass
Give assistants scoped, read-only-by-default access to your Unix pass and GPG store
- Pricing
- Open source
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Unix pass
Unix pass is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.
Handing a password store to a language model raw invites mistakes, so this server wraps the safe subset of the pass command. It is read-only by default; writes, key administration and network operations each need an explicit environment opt-in. Access is scoped by PASS_MCP_ALLOWED_PATHS, whose default is web/*, so only entries you choose are exposed.
The README describes a single chokepoint for subprocesses, strict input validation, no shell, no clipboard use, no secrets in logs, sanitised errors and an append-only audit log. It checks for a reachable gpg-agent before decrypting, and because the server cannot answer a passphrase prompt itself, you need a GUI pinentry, a zenity or kdialog dialog via unlock_agent, or a pre-warmed agent.
There are 24 tools in total, covering reading, safe writes, key administration, TOTP codes and git operations. The package is on PyPI as unix-pass-mcp and needs Python 3.11 or newer, pass and GnuPG. The author also provides a workflow guide for pairing it with a browser-controlling MCP for sign-up and login tasks.
Install
Run in a terminal
claude mcp add unix-pass-mcp -- uvx unix-pass-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"unix-pass-mcp": {
"command": "uvx",
"args": [
"unix-pass-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"unix-pass-mcp": {
"command": "uvx",
"args": [
"unix-pass-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"unix-pass-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"unix-pass-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"unix-pass-mcp": {
"command": "uvx",
"args": [
"unix-pass-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"unix-pass-mcp": {
"command": "uvx",
"args": [
"unix-pass-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PASS_MCP_ALLOWED_PATHSComma-separated entry globs. Scope the server to entries you intend to expose.PASSWORD_STORE_DIROptional absolute password-store path; defaults to the user's ~/.password-store.
Tools this server provides (12)
Taken from the project documentation; the running server may differ.
- store_info
- Inspects the store path, recipients and status without decrypting.
- list
- Lists pass names, optionally within a subfolder.
- find
- Searches leaf names by substring.
- show
- Decrypts and returns one line of an entry.
- show_field
- Decrypts and returns one named metadata field.
- show_metadata
- Returns entry shape without the password value.
- unlock_agent
- Opens a desktop password dialog to warm gpg-agent.
- otp
- Generates a one-time password for an entry.
- git_status
- Shows the store's git status.
- git_log
- Shows the store's git log.
- git_pull
- Pulls the store's git repository.
- git_push
- Pushes the store's git repository.
What it does
- Read-only default
- Writes and destructive operations need explicit opt-ins.
- Path scopes
- Limits exposure to entries matching configured globs.
- Metadata without secrets
- show_metadata returns field names and line count, never the password.
- TOTP support
- Includes a native RFC 6238 one-time-password tool.
- Git integration
- Auto-commit on writes and git status, log, pull and push tools.
- Audit and sanitising
- Append-only audit log and sanitised error output.
Good for
- Let an agent look up a login for a scoped set of entries
- Generate a TOTP code during an automated sign-in
- Inspect which fields an entry has without revealing the password
- Rotate credentials in a signup and login workflow
- Check store and recipient status
Pricing
Open source
Free, installed from PyPI
Unix pass FAQ
Can the assistant change my passwords?
Only if you enable writes through an environment variable; the default is read-only.
How do I limit what it can see?
Set PASS_MCP_ALLOWED_PATHS to comma-separated entry globs; the default is web/*.
What do I need installed?
Python 3.11 or newer, pass, GnuPG with gpg-agent, a configured key and an initialised store.
How many tools are there?
24, grouped by read, write, key administration, TOTP and git capabilities.
Is Unix pass free?
Yes. Unix pass is open source, so you can use and self-host it for free.
How do I add Unix pass to Claude Code?
Run this command in your terminal: claude mcp add unix-pass-mcp -- uvx unix-pass-mcp
What are the best alternatives to Unix pass?
The closest alternatives to Unix pass are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


