← ClaudeAtlas

1password-api-patternslisted

1Password MCP fundamentals through Conduit: the region plus two independent credential halves (Events Reporting token, Users API client) and their X-OnePassword-* headers, which of the six read-only tools needs which half, which three are admin-gated in Conduit, cursor paging on the Events feeds, page-token paging on users, time windows and 120-day retention, rate limits, and how vendor errors come back.
WYRE-AI/msp-claude-plugins · ★ 55 · Data & Documents · score 84
Install: claude install-skill WYRE-AI/msp-claude-plugins
# 1Password API Patterns ## Overview The 1Password connector is a read-only security view of one 1Password Business or Enterprise account per connection. It wraps two official APIs: the Events API (audit trail, shared-vault item usage, sign-in attempts) and the Users API (user inventory). Neither returns secret values, and vault contents are never reachable. ## Credentials and headers Each client account is one Conduit connection, set up in the Conduit web UI. Conduit sends the stored values to the MCP server as headers (nothing is configured on the client, and Conduit drops any `X-OnePassword-*` header a client sends): | Field | Header | Required | |---|---|---| | Region (`us`, `ent`, `ca`, `eu`) | `X-OnePassword-Region` | Always | | Events Reporting token | `X-OnePassword-Events-Token` | For the Events tools | | Users API client ID | `X-OnePassword-Client-Id` | For the Users tools | | Users API client secret | `X-OnePassword-Client-Secret` | For the Users tools | | Account ID (26 characters) | `X-OnePassword-Account-Id` | For the Users tools | A connection can carry the Events token, the Users API client, or both. A tool whose half is missing fails with a credential error; it never falls back to the other half. ## Tools, credentials and Conduit tiers | Tool | Credential | Conduit tier | |---|---|---| | `1password_events_introspect` | Events token | read | | `1password_audit_events_list` | Events token with `auditevents` | admin | | `1password_item_usages_list` | Eve