onepassword MCP Server

Use This MCP server To

Provide secure credential access to AI agents during automation Integrate 1Password secrets into AI-driven workflows Enable Agentic AI to retrieve passwords without manual input Automate secure authentication in multi-step AI tasks Centralize secret management for AI applications Facilitate secure API key retrieval for AI tools

README

Project Note: ⚠️ This MCP server is a proof of concept and is intended for educational purposes only. It utilizes the 1Password Python SDK to securely retrieve credentials from your 1Password account and provides them via the MCP Python SDK to Agentic AI for use in its operations. ⚠️

Quick Start

Installing via Smithery

To install 1Password Credential Retrieval Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @dkvdm/onepassword-mcp-server --client claude

Prerequisites

Python 3.11 or higher
uv (fast Python package installer): pip install uv
Install packages: uv sync
Create a vault within 1Password named AI, and add the items you want to use.
Create a service account and give it the appropriate permissions in the vaults where the items you want to use with the SDK are saved.
Provision your service account token, and configure clients like Claude Desktop to connect to this server. Add the following structure to the client's configuration (e.g., claude_desktop_config.json), adjusting the path and environment variables as needed:

// Example for Claude Desktop config
{
  "mcpServers": {
    "1Password": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "onepassword-sdk",
        "mcp",
        "run",
        "/your/dir/here/onepassword-mcp-server/server.py" // Change this path
      ],
      "env": {
        "OP_SERVICE_ACCOUNT_TOKEN": "INSERT_KEY_HERE" // Insert 1Password Service Account Token
      }
    }
  }
}

Launch Claude and try a prompt such as "Get 1Password credentials for ticktick.com" (based on item name)

Automate Browser with 1Password and Browser-Use MCP

Install mcp-browser-use and configure both MCP servers as such:

// Example for Claude Desktop config
{
  "mcpServers": {
    "1Password": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "onepassword-sdk",
        "mcp",
        "run",
        "/your/dir/here/onepassword-mcp-server/server.py"
      ],
      "env": {
        "OP_SERVICE_ACCOUNT_TOKEN": "INSERT_KEY_HERE"
      }
    },
    "browser-use": {
      "command": "uv",
      "args": [
        "--directory",
        "/your/dir/here/mcp-browser-use",
        "run",
        "mcp-server-browser-use"
      ],
      "env": {
        "MCP_USE_OWN_BROWSER": "true",
        "CHROME_CDP": "http://127.0.0.1:9222",
        "ANTHROPIC_API_KEY": "INSERT_KEY_HERE",
        "PYTHONIOENCODING": "utf-8",
        "PYTHONUNBUFFERED": "1",
        "PYTHONUTF8": "1"
      }
    }
  }
}

Launch Claude and try a prompt such as "get 1Password credentials for ticktick.com and log into https://ticktick.com/signin"

onepassword-mcp-server FAQ

How do I install the onepassword-mcp-server?

Install via Smithery CLI using 'npx -y @smithery/cli install @dkvdm/onepassword-mcp-server --client claude' and ensure Python 3.11+ is installed.

What prerequisites are needed to run this MCP server?

You need Python 3.11 or higher, the 'uv' package installer, a 1Password vault named 'AI', and a 1Password service account.

Is this MCP server production-ready?

No, it is a proof of concept intended for educational purposes only.

How does the server securely access 1Password credentials?

It uses the official 1Password Python SDK with a service account to securely retrieve vault items.

Can this server be used with different AI clients?

Yes, it exposes credentials via the MCP Python SDK, compatible with any MCP client like Agentic AI, Claude, or Gemini.

What programming language is required to run this server?

The server is implemented in Python and requires Python 3.11 or higher.

How do I add credentials for retrieval?

Create a vault named 'AI' in 1Password and add the desired items there for the server to access.

Does this server handle credential caching?

The documentation does not specify caching; it retrieves credentials securely on demand via the 1Password SDK.