Skip to main content
You can programmatically retrieve the secrets stored in 1Password Environments using 1Password SDKs or 1Password CLI. Both tools support local authentication with the 1Password desktop app or automated authentication with service accounts scoped to specific Environments.
Upcoming deprecationThe following functionality will be deprecated on November 17, 2026, and removed on January 20, 2027:
  • The op environment read command in 1Password CLI. To list the secrets in an Environment, use op environment secret list instead, available in version 2.42.0 or later. To pass secrets from an Environment to an application or script, use op run --environment.
  • The get_variables() function in 1Password SDKs, and the GetVariablesResponse and EnvironmentVariable types it returns. The new list_secrets() function will replace them. It takes an Environment name or ID and a reveal option, and returns a list of EnvironmentSecret objects directly, without a response wrapper.

Choose your configuration

Tool options

  • 1Password CLI: Best for quick testing, shell scripts, CI/CD pipelines, Infrastructure as Code, build tools and task runners.
  • 1Password SDKs: Best for native integrations with Go, Python, or JavaScript applications.

Authentication options

  • Local authentication with the 1Password desktop app: Authenticate in the same way you unlock your 1Password desktop app, like with biometrics or your 1Password account password. Requires minimal setup with no token management. Enables human-in-the-loop approval for sensitive workflows.
  • 1Password Service Accounts: Authenticate using a service account token scoped to the Environments you want to fetch. Best for shared building, automated access, and headless server authentication. Enables you to follow the principle of least privilege in your project.

Decision guide

Use the table below to find the best tool and authentication method for your specific use case.

Get an Environment’s ID

To fetch secrets from a 1Password Environment, you’ll need its unique identifier (ID). You can get an Environment’s ID in the 1Password desktop app:
  1. Open and unlock the 1Password desktop app, then navigate to Developer > View Environments.
  2. Select View environment next to the Environment you want to fetch.
  3. Select Manage environment > Copy environment ID.

Read Environments with 1Password SDKs

Get secrets

With 1Password SDKs, you can retrieve the secrets stored in your 1Password Environments using the get_variables() function with the Environment’s ID.
The function returns a GetVariablesResponse object that contains a list of the secrets stored in the Environment.
Each secret in the response is returned as an EnvironmentVariable object that contains the secret’s name (for example, DB_HOST), value, and whether the value is hidden by default.
By default, secrets in 1Password Environments have “Hide value by default” turned on. To change this, open an Environment, select the vertical ellipsis next to the secret, then select Show value by default.

Examples

Before running the following example:
  • Set OP_SERVICE_ACCOUNT_TOKEN to the token for a service account that has access to the Environment you want to fetch.
  • Set OP_ENVIRONMENT_ID to the ID for your 1Password Environment.

Read Environments with 1Password CLI

With 1Password CLI, you can pass the secrets stored in your 1Password Environments to an application or script using op run --environment. You can also retrieve them from your 1Password Environments with op environment read (beta).

Before you get started

Before you get started, install 1Password CLI. To use op environment read, you’ll need the latest beta build of 1Password CLI, version 2.33.0-beta.02 or later. Then choose your authentication method:
  • Local authentication with the 1Password desktop app: Authenticate in the same way you unlock your 1Password desktop app, like with biometrics or your 1Password account password. To set up local authentication, turn on the 1Password CLI desktop app integration.
  • Service account: Authenticate using a service account token that can only access the Environments you want to fetch. To authenticate using a service account token, create a new service account with read access to the appropriate Environments. Then export your service account token:

Pass secrets to an application or script

op run --environment is available in the stable release of 1Password CLI, version 2.41.0 or later. To pass secrets from a 1Password Environment to an application or script as environment variables, use op run with the --environment flag and the Environment’s ID, then pass the results to the application or script. 1Password CLI runs the application or script as a subprocess with your secrets loaded into the environment for the duration of the process.
By default, secrets in 1Password Environments have “Hide value by default” turned on. Hidden secrets are automatically concealed in stdout and stderr output. To change this, open an Environment, select the vertical ellipsis next to the secret, then select Show value by default. Or use the --no-masking flag with op run.

Use with environment variables from multiple sources

You can also use op run with multiple environments, or in combination with .env files or shell environment variables. When the same environment variable exists in multiple sources, 1Password CLI gives them the following precedence:
  1. 1Password Environments (highest priority)
  2. Environment files
  3. Shell environment variables (lowest priorities)
If a secret with the same name exists in multiple 1Password Environments, the last Environment specified takes precedence.

Examples

To print a single secret from a 1Password Environment, pass its name to printenv. Because Environment secrets are hidden by default, the value stays concealed in the output:
To run a script provisioned with the secrets from an Environment:

Get secrets (beta)

Beta featureop environment read is available in the latest beta build of 1Password CLI, version 2.33.0-beta.02 or later.
To read secrets from a 1Password Environment, use op environment read with the Environment’s ID. 1Password CLI will return a list of the secrets in the Environment formatted as key-value pairs.

Examples

To get the secrets for a local development Environment with the ID blgexucrwfr2dtsxe2q4uu7dp4:
After you fetch the Environment, you can pipe the results to other tools. For example:

Learn more