dkvdm/onepassword-mcp-server

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"