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.0.tar.gz (2.6 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.0-py3-none-any.whl (2.5 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for mseep_onepassword_mcp_server-0.1.0.tar.gz
Algorithm Hash digest
SHA256 58446a9217a824b7249c002f9a4f6b27d60fce055e699e5060c8c827915c1300
MD5 dccf8a57fbf680d3bc2c670af4d6fd44
BLAKE2b-256 cf88c02aa010fb4fc7091fbecfd86b4e234a72156efc95bb8626ad0a33a7ac18

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mseep_onepassword_mcp_server-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4d7fd6c00ae41104987a50e5bc981858ea102e47fb245b633618696293b84f5d
MD5 fcde2602278e1cd3735295b9d5afef38
BLAKE2b-256 7542828b4beb5a31e157a17d9e7208a3b4fc8422a91bb0a6c10759a3e8b3dd0c

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