Skip to content
MCP server

Onepassword Agent MCP

Let agents use and save 1Password secrets locally without ever seeing the plaintext

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.4.2
Listing updated
1 day ago

About Onepassword Agent MCP

Onepassword Agent MCP is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "onepassword-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "onepassword-agent-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Open source

Free npm package; requires a 1Password account

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 to Onepassword Agent MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  3. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  4. Leash

    MCP server

    Review what your AI touched, approve risky actions and undo supported changes

    • 1 tool
    • Remote
    • Free
    • 1 GitHub star
    • Security
  5. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security