# 1password — how to use (mcp.ai)

Connect your 1password account and use 6 tools for security and identity straight from your AI agent. Connect with your own API key. Password manager and digital vault for secure credential storage and team collaboration.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p__1password?ms=1787293440000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `_1password_create_item`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/_1password`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/_1password/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/_1password/create/item` — Creates a new item in a 1Password vault.
  - body: { tags?: string[], title: string, fields?: object[], category?: string, vault_id: string }
- `POST https://api.mcp.ai/api/_1password/delete/item` — Permanently deletes an item from a 1Password vault.
  - body: { item_id: string, vault_id: string }
- `POST https://api.mcp.ai/api/_1password/get/item` — Retrieves a specific item from a vault, including all fields and secrets.
  - body: { item_id: string, vault_id: string }
- `POST https://api.mcp.ai/api/_1password/list/items` — Lists all items in a given vault.
  - body: { vault_id: string }
- `POST https://api.mcp.ai/api/_1password/list/vaults` — Lists all vaults the service account has access to.
- `POST https://api.mcp.ai/api/_1password/update/item` — Updates an existing item's title or field values.
  - body: { title?: string, fields?: object[], item_id: string, vault_id: string }

## Example prompts
- "What can I do in 1password?"
- "Show me a summary of my 1password account"

## More
- Page: https://mcp.ai/_1password
- Agent spec (llms.txt): https://mcp.ai/_1password/llms.txt
- Postman collection: https://mcp.ai/_1password/postman.json
