# Unix pass

> Unix pass is an open-source MCP server for security. Give assistants scoped, read-only-by-default access to your Unix pass and GPG store. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, self-hosted
- **Repository:** https://github.com/neanderthal/unix-pass-mcp
- **MCP Registry name:** io.github.Neanderthal/unix-pass-mcp
- **Categories:** [security](https://ai-powered.com/categories/security), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add unix-pass-mcp -- uvx unix-pass-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "unix-pass-mcp": {
      "command": "uvx",
      "args": [
        "unix-pass-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "unix-pass-mcp": {
      "command": "uvx",
      "args": [
        "unix-pass-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "unix-pass-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "unix-pass-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "unix-pass-mcp": {
      "command": "uvx",
      "args": [
        "unix-pass-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "unix-pass-mcp": {
      "command": "uvx",
      "args": [
        "unix-pass-mcp"
      ]
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/unix-pass
