# Onepassword Agent MCP

> Onepassword Agent MCP is an open-source MCP server for security. Let agents use and save 1Password secrets locally without ever seeing the plaintext. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, self-hosted
- **Repository:** https://github.com/gambadio/onepassword-agent-mcp
- **MCP Registry name:** io.github.gambadio/onepassword-agent-mcp
- **Categories:** security
- **Listing updated:** 2026-11-16

## About

This is an independent project, not affiliated with 1Password. Agents receive encrypted handles instead of values; the local server resolves the chosen field and copies or pastes it where needed, so plaintext never returns to the model. A dashboard at 127.0.0.1:7319 lets you approve exactly which fields from which items an agent may use and on which websites.

Saving works in reverse: copy a password or API key in your browser, then the agent calls save_secret_from_clipboard with metadata only such as title, category and URL, and the server stores it in 1Password and verifies it. Categories are login, password, api_credential and secure_note. An encrypted retry snapshot is usable for 15 minutes.

Three opt-in permissions are off on a fresh install: allow saving new items, allow clipboard saves and auto-approve created items. An optional scoped service account avoids repeated desktop unlock prompts. A Profile view holds non-secret data like email or address that agents may read directly. It needs Node.js 20, the 1Password CLI and installs from npm, with an activity log of operations without secret values.

## Features

- **Encrypted handles:** Agents never receive plaintext secrets.
- **Field-level approvals:** Choose exact fields and allowed websites.
- **Clipboard save:** Store a copied secret with metadata-only arguments.
- **Local dashboard:** Vault, permissions, profile and activity views.
- **Opt-in permissions:** Saving and auto-approval are off by default.
- **Service account option:** Scoped account for unattended use.

## Good for

- Let an agent log into a site without exposing the password
- Save a new API key from the clipboard into 1Password
- Limit a credential to specific websites
- Review what agents did in an activity log
- Share profile data like address with agents

## Install

### Claude Code (Terminal)

```sh
claude mcp add onepassword-agent-mcp -- npx -y onepassword-agent-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "onepassword-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "onepassword-agent-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "onepassword-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "onepassword-agent-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "onepassword-agent-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "onepassword-agent-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "onepassword-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "onepassword-agent-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "onepassword-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "onepassword-agent-mcp"
      ]
    }
  }
}
```

## FAQ

### Does the agent see my password?

No, it works with encrypted handles.

### What do I need?

Node.js 20, the 1Password CLI and an MCP client with stdio support.

### Is it official?

No, it is independent and not affiliated with 1Password.

### Where does the dashboard run?

Locally on 127.0.0.1 port 7319.

### Is Onepassword Agent MCP free?

Yes. Onepassword Agent MCP is open source, so you can use and self-host it for free.

### How do I add Onepassword Agent MCP to Claude Code?

Run this command in your terminal: claude mcp add onepassword-agent-mcp -- npx -y onepassword-agent-mcp

### What are the best alternatives to Onepassword Agent MCP?

The closest alternatives to Onepassword Agent MCP are REA, Agent Roast, Midplane, Leash and Tinplate Edge AI Safety, Security & EU Compliance.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/onepassword-agent-mcp
