Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 6 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ 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
Note: This plugin supports macOS, Windows, and Linux.

#### Documentation
https://www.1password.dev/environments/mcp-codex-server
Expand All @@ -18,7 +18,7 @@ https://www.1password.dev/environments/mcp-codex-server
- `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.
desktop app's bundled `1password-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.
Expand All @@ -27,14 +27,15 @@ https://www.1password.dev/environments/mcp-codex-server

## Prerequisites

- macOS with the 1Password desktop app installed.
- macOS, Windows, or Linux 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:
The MCP server runs via the `1password-mcp` alias, which the 1Password
desktop app installs on your `PATH`:

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

## Using the Plugin
Expand Down
2 changes: 1 addition & 1 deletion plugins/1password/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "1password",
"version": "0.1.0",
"version": "0.2.0",
"description": "Use the local 1Password MCP server to manage 1Password Developer Environments and local .env mounts from Codex.",
"author": {
"name": "1Password"
Expand Down
2 changes: 1 addition & 1 deletion plugins/1password/.mcp.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"mcpServers": {
"1password": {
"command": "/Applications/1Password.app/Contents/MacOS/onepassword-mcp",
"command": "1password-mcp",
"args": []
}
}
Expand Down
6 changes: 4 additions & 2 deletions plugins/1password/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,15 @@ This plugin connects Codex to the 1Password desktop app's local MCP server for 1

## MCP Server

The plugin starts the bundled macOS binary:
The plugin starts the 1Password MCP server via the `1password-mcp` alias, which
the 1Password desktop app installs on your `PATH` (supported on macOS, Windows,
and Linux):

```json
{
"mcpServers": {
"1password": {
"command": "/Applications/1Password.app/Contents/MacOS/onepassword-mcp",
"command": "1password-mcp",
"args": []
}
}
Expand Down
2 changes: 1 addition & 1 deletion plugins/1password/skills/1password-environments/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -104,4 +104,4 @@ No resource templates are currently exposed.

## Notes

The local MCP server is enabled from 1Password Labs in the desktop app and connects through the bundled `onepassword-mcp` binary. Local `.env` mounts are supported on macOS and Linux.
The local MCP server is enabled from 1Password Labs in the desktop app and connects through the `1password-mcp` alias installed on your `PATH`, which is supported on macOS, Windows, and Linux. Local `.env` mounts are supported on macOS and Linux.