Skip to Content

ReferenceCommandsMCP servers and outside services

turno secret

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

View source
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

turno secret set

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

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

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

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

On this page