# 1password Codex Plugin

> A Codex plugin for the 1Password Developer Environments MCP server

- **Type:** MCP server
- **Install:** `agentstack add mcp-1password-1password-codex-plugin`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [1Password](https://agentstack.voostack.com/s/1password)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [1Password](https://github.com/1Password)
- **Source:** https://github.com/1Password/1password-codex-plugin

## Install

```sh
agentstack add mcp-1password-1password-codex-plugin
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 1Password Codex Plugin

This repository contains a Codex plugin that connects Codex to the
1Password desktop app's local MCP server for 1Password Developer Environments.

The plugin lets Codex help with secure project environment setup, such as
listing Developer Environments, inspecting variable names, adding variables, and
creating local `.env` mounts. Secret values remain controlled by 1Password and
are never shared with Codex.

Note: This plugin currently only supports MacOS

#### Documentation
https://www.1password.dev/environments/mcp-codex-server

## What's Included

- `plugins/1password/.codex-plugin/plugin.json` - Codex plugin metadata and UI
  configuration.
- `plugins/1password/.mcp.json` - MCP server configuration for the 1Password
  desktop app's bundled `onepassword-mcp` binary.
- `plugins/1password/skills/1password-environments/SKILL.md` - Codex skill
  instructions for using 1Password Developer Environments.
- `plugins/1password/assets/` - Plugin icon and logo assets.
- `.agents/plugins/marketplace.json` - Local marketplace entry that points Codex
  at `plugins/1password`.

## Prerequisites

- macOS with the 1Password desktop app installed.
- 1Password Labs MCP server experiment enabled in the desktop app.
- Access to a 1Password account with Developer Environments enabled.

The MCP server is expected at:

```text
/Applications/1Password.app/Contents/MacOS/onepassword-mcp
```

## Using the Plugin

Once installed or enabled in Codex, you can ask for tasks like:

- "List my 1Password Environments"
- "Create a local .env mount here"
- "Show me the variable names in my project environment"
- "Add a placeholder variable for my OpenAI API key"

The 1Password desktop app may prompt for approval when Codex connects to the MCP
server or accesses an Environment.

## Exposed MCP Tools

The plugin exposes these 1Password MCP tools to Codex:

- `authenticate`
- `list_environments`
- `create_environment`
- `rename_environment`
- `list_variables`
- `append_variables`
- `create_local_env_file`
- `list_local_env_files`

## License

MIT. See [LICENSE](LICENSE).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [1Password](https://github.com/1Password)
- **Source:** [1Password/1password-codex-plugin](https://github.com/1Password/1password-codex-plugin)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-1password-1password-codex-plugin
- Seller: https://agentstack.voostack.com/s/1password
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.