Skip to main content

An MCP server that enables secure credential retrieval from 1Password to be used by Agentic AI

Project description

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"
      }
    }
  }
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mseep_onepassword_mcp_server-0.1.1.tar.gz (2.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mseep_onepassword_mcp_server-0.1.1-py3-none-any.whl (2.5 kB view details)

Uploaded Python 3

File details

Details for the file mseep_onepassword_mcp_server-0.1.1.tar.gz.

File metadata

File hashes

Hashes for mseep_onepassword_mcp_server-0.1.1.tar.gz
Algorithm Hash digest
SHA256 865f9c90f088074cc522d9d859621dfea6ada05b5a6cb1bbe6eab5d51a3eb1ff
MD5 fa17f56bac0cf575ff3e94998c198ce0
BLAKE2b-256 82385ad7f65942f1234af0e90abfc618d21a04849dd5b05ad8cba1acb43eaf2b

See more details on using hashes here.

File details

Details for the file mseep_onepassword_mcp_server-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for mseep_onepassword_mcp_server-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d63d7ece5165bb35c0cb892ec4139b78bc4aa4c464bbdc099edf24342320396b
MD5 64dc7111cbb36399975dd01326dde6e3
BLAKE2b-256 3eaad1c1b0a0c31665acc7c01004cbb0afce74815c276bdd7d4de1979135d262

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page