# turno secret (/docs/reference/cli/secret)

Store MCP secrets in the Keychain (macOS) or the Secret Service (Linux)

```text title="turno secret --help"
Usage:
  turno secret set <service>     read a value from stdin and store it
  turno secret has <service>     exit 0 when the item exists
  turno secret rm <service>      delete the item
  turno secret list [--json]     every keychain: reference in mcp.toml and whether it is stored

Reference it in mcp.toml as "keychain:<service>". Values are never printed and never passed
as a command argument. The store is the login Keychain on macOS and the Secret Service
(libsecret's secret-tool, attributes service=turno account=<service>) on Linux. Without
either, use "env:NAME" references.

Examples:
  $ printf %s "$TOKEN" | turno secret set github-token
  $ turno secret has github-token
  $ turno secret list --json
```

## Subcommands [#subcommands]

### turno secret set [#turno-secret-set]

```text
Usage:
  turno secret set <service>     read a value from stdin and store it
  turno secret has <service>     exit 0 when the item exists
  turno secret rm <service>      delete the item
  turno secret list [--json]     every keychain: reference in mcp.toml and whether it is stored

Reference it in mcp.toml as "keychain:<service>". Values are never printed and never passed
as a command argument. The store is the login Keychain on macOS and the Secret Service
(libsecret's secret-tool, attributes service=turno account=<service>) on Linux. Without
either, use "env:NAME" references.

Examples:
  $ printf %s "$TOKEN" | turno secret set github-token
  $ turno secret has github-token
  $ turno secret list --json
```

### turno secret has [#turno-secret-has]

```text
Usage:
  turno secret set <service>     read a value from stdin and store it
  turno secret has <service>     exit 0 when the item exists
  turno secret rm <service>      delete the item
  turno secret list [--json]     every keychain: reference in mcp.toml and whether it is stored

Reference it in mcp.toml as "keychain:<service>". Values are never printed and never passed
as a command argument. The store is the login Keychain on macOS and the Secret Service
(libsecret's secret-tool, attributes service=turno account=<service>) on Linux. Without
either, use "env:NAME" references.

Examples:
  $ printf %s "$TOKEN" | turno secret set github-token
  $ turno secret has github-token
  $ turno secret list --json
```

### turno secret rm [#turno-secret-rm]

```text
Usage:
  turno secret set <service>     read a value from stdin and store it
  turno secret has <service>     exit 0 when the item exists
  turno secret rm <service>      delete the item
  turno secret list [--json]     every keychain: reference in mcp.toml and whether it is stored

Reference it in mcp.toml as "keychain:<service>". Values are never printed and never passed
as a command argument. The store is the login Keychain on macOS and the Secret Service
(libsecret's secret-tool, attributes service=turno account=<service>) on Linux. Without
either, use "env:NAME" references.

Examples:
  $ printf %s "$TOKEN" | turno secret set github-token
  $ turno secret has github-token
  $ turno secret list --json
```

### turno secret list [#turno-secret-list]

```text
Usage:
  turno secret set <service>     read a value from stdin and store it
  turno secret has <service>     exit 0 when the item exists
  turno secret rm <service>      delete the item
  turno secret list [--json]     every keychain: reference in mcp.toml and whether it is stored

Reference it in mcp.toml as "keychain:<service>". Values are never printed and never passed
as a command argument. The store is the login Keychain on macOS and the Secret Service
(libsecret's secret-tool, attributes service=turno account=<service>) on Linux. Without
either, use "env:NAME" references.

Examples:
  $ printf %s "$TOKEN" | turno secret set github-token
  $ turno secret has github-token
  $ turno secret list --json
```