Skip to content
MCP server

Unix pass

Give assistants scoped, read-only-by-default access to your Unix pass and GPG store

Runs locallyStatus and history
Install
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "unix-pass-mcp": {
      "command": "uvx",
      "args": [
        "unix-pass-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "unix-pass-mcp": {
      "command": "uvx",
      "args": [
        "unix-pass-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers