Skip to main content
Glama
kefapps

mcp-1password

by kefapps

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
OP_MCP_ACCOUNTNo1Password account name or UUID, required in desktop mode
OP_CONNECT_HOSTNoConnect API URLhttp://127.0.0.1:8080
OP_CONNECT_TOKENNoConnect access token, required in connect mode
OP_MCP_AUTH_MODENoAuthentication mode: desktop, service-account, or connectdesktop
OP_MCP_HTTP_HOSTNoHTTP bind address127.0.0.1
OP_MCP_HTTP_PATHNoHTTP path prefix/mcp
OP_MCP_HTTP_PORTNoHTTP port17337
OP_MCP_LOG_LEVELNoLog levelinfo
OP_MCP_TRANSPORTNoTransport type: stdio or httpstdio
OP_MCP_OP_CLI_PATHNoPath to the op binaryop
OP_MCP_ENABLE_WRITESNoAllow item and vault creation/updatefalse
OP_MCP_AUDIT_LOG_PATHNoAudit log path~/.onepassword-mcp/audit.jsonl
OP_MCP_OP_CLI_AUTH_MODENoCLI authentication modeauto
OP_MCP_HTTP_BEARER_TOKENNoBearer token (minimum 16 characters) required when HTTP transport is enabled
OP_MCP_HTTP_MAX_SESSIONSNoMaximum active HTTP MCP sessions64
OP_SERVICE_ACCOUNT_TOKENNoService account token, required in service-account mode
OP_MCP_HTTP_REQUIRE_BEARERNoRequire Authorization: Bearertrue
OP_MCP_SCRIPT_RUNNER_ROOTSNoTrusted workspace root (repeatable, comma-separated)
OP_MCP_ENABLE_SCRIPT_RUNNERNoAllow execution of allowlisted scriptsfalse
OP_MCP_ENABLE_SECRET_REVEALNoAllow plaintext secret revealfalse
OP_MCP_HTTP_ALLOWED_ORIGINSNoBrowser origins allowed for HTTP transport (comma-separated)
OP_MCP_HTTP_SESSION_IDLE_MSNoIdle HTTP session expiry in milliseconds900000
OP_MCP_HTTP_REQUEST_TIMEOUT_MSNoHTTP request timeout in milliseconds30000
OP_MCP_APPROVAL_REMEMBER_TTL_MSNoLifetime for remembered approvals86400000
OP_MCP_SCRIPT_RUNNER_ALLOWLISTSNoAbsolute path to an allowlist file (repeatable, comma-separated in env)
OP_MCP_UNRESTRICTED_RUNNER_ROOTSNoRoot path eligible for unrestricted execution approval (repeatable, comma-separated)
OP_MCP_APPROVAL_REMEMBER_KEY_PATHNoLocal 32-byte AES key file~/.onepassword-mcp/approval-grants.key
OP_MCP_ENABLE_DESTRUCTIVE_ACTIONSNoAllow archive and delete operationsfalse
OP_MCP_ENABLE_PERMISSION_MUTATIONNoAllow vault permission changesfalse
OP_MCP_ENABLE_UNRESTRICTED_RUNNERNoAllow the separate free-form shell command runnerfalse
OP_MCP_APPROVAL_REMEMBER_STORE_PATHNoEncrypted local approval grants file~/.onepassword-mcp/approval-grants.enc.json
OP_MCP_ACKNOWLEDGE_UNRESTRICTED_RUNNERNoRequired only when disabling session approval; exact value: I_UNDERSTAND_THIS_ALLOWS_UNRESTRICTED_LOCAL_COMMAND_EXECUTION
OP_MCP_ENABLE_UNRESTRICTED_SCRIPT_RUNNERNoEnable free-form shell commands with local approvalfalse
OP_MCP_SCRIPT_RUNNER_ALLOWLIST_MANIFESTSNoAbsolute path to a manifest listing allowlist files (repeatable, comma-separated)
OP_MCP_UNRESTRICTED_RUNNER_APPROVAL_HOSTNoLocal approval server bind host127.0.0.1
OP_MCP_UNRESTRICTED_RUNNER_APPROVAL_PORTNoLocal approval server port; 0 picks a free port0
OP_MCP_UNRESTRICTED_RUNNER_APPROVAL_TTL_MSNoIn-memory approval lifetime in milliseconds43200000
OP_MCP_UNRESTRICTED_RUNNER_COMMAND_TIMEOUT_MSNoFree-form command timeout in milliseconds600000
OP_MCP_UNRESTRICTED_RUNNER_REQUIRE_SESSION_APPROVALNoRequire local approval page before commands can runtrue

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}
completions
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
sdk_capabilitiesA

Describe the capability surface exposed by this server, including the preferred no-plaintext path for consuming secrets in scripts.

op_session_statusA

Show non-secret 1Password CLI session state and runtime capability gates held by this MCP process.

password_generateA

Generate a strong random password and return it in plaintext for immediate use. Requires a reason and generated-secret acknowledgement.

password_generate_memorableB

Generate a memorable passphrase-like password and return it in plaintext for immediate use. Requires a reason and generated-secret acknowledgement.

password_readA

Read one password field or secret reference. Returns redacted metadata by default. Plaintext reveal is disabled in this server; reveal=true will fail. If the secret only needs to be consumed by a command or local script, do not request reveal. op_script_run is not available because the script runner is also disabled here; restart the server with --enable-script-runner=true plus startup --script-runner-allowlist or --script-runner-allowlist-manifest entries to allow no-plaintext secret consumption by scripts.

vault_listC

List vaults visible to the authenticated 1Password integration.

vault_getC

Get vault details and, optionally, accessor permissions for one vault.

group_getB

Get one group by ID. This is the only group read endpoint exposed by the official JS SDK beta today.

vault_permissions_getC

Get vault accessor permissions. The JS SDK beta exposes this through vault accessors.

item_searchC

Search item overviews by title/tags/category. If no vault is provided, the server searches every visible vault client-side.

item_request_listA

Review placeholder items created with item_request_create and tagged 'mcp-managed'. Returns provenance plus filled/awaiting-fill status without returning credential values.

item_get_metadataA

Get item metadata with every field value redacted. Use secret_reveal only when plaintext is explicitly required.

environment_get_variablesA

Get 1Password Environment variables with values redacted. Supports simple client-side filtering by variable name. When a secret is needed only by a command or local script, prefer op_script_run with envSecretRefs so the secret is injected into the child process and never returned in plaintext.

environment_get_variableA

Get one 1Password Environment variable by exact name, with the value redacted. When a secret is needed only by a command or local script, prefer op_script_run with envSecretRefs so the secret is injected into the child process and never returned in plaintext.

environment_reveal_variableC

Plaintext reveal is disabled in this server; this tool will fail until the server is restarted with OP_MCP_ENABLE_SECRET_REVEAL=true or --enable-secret-reveal=true. If the secret only needs to be consumed by a command or local script, do not call this tool. op_script_run is not available because the script runner is also disabled here; restart the server with --enable-script-runner=true plus startup --script-runner-allowlist or --script-runner-allowlist-manifest entries to allow no-plaintext secret consumption by scripts.

secret_revealD

Plaintext reveal is disabled in this server; this tool will fail until the server is restarted with OP_MCP_ENABLE_SECRET_REVEAL=true or --enable-secret-reveal=true. If the secret only needs to be consumed by a command or local script, do not call this tool. op_script_run is not available because the script runner is also disabled here; restart the server with --enable-script-runner=true plus startup --script-runner-allowlist or --script-runner-allowlist-manifest entries to allow no-plaintext secret consumption by scripts.

Prompts

Interactive templates invoked by user choice

NameDescription
credential-rotationGuide a safe password rotation workflow using redacted reads first, then explicit reveal only if required.
vault-auditAudit a vault using metadata and redacted item reads, without revealing secrets by default.
environment-inspectionInspect a 1Password Environment in redacted mode, and reveal one variable only if there is an explicit operational reason.
generate-secure-passwordChoose the right password helper, generate a value, and optionally store it in 1Password.

Resources

Contextual data attached and managed by the client

NameDescription
1password-configNon-secret runtime configuration and capability summary for this server.
1password-vaultsBrowse the vaults visible to the active 1Password integration.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kefapps/onepassword-mcp-codex'

If you have feedback or need assistance with the MCP directory API, please join our Discord server