Skip to main content

Config TOML

Default paths:

Linux: ~/.config/teams-cli/config.toml
macOS: ~/Library/Application Support/teams-cli/config.toml
Windows: %APPDATA%\teams-cli\config.toml

Example:

[default]
profile = "prod"
output = "json"
page_size = 50

[profiles.prod]
auth_app = "oso"
tenant_id = "example.onmicrosoft.com"
auth_flow = "device-code"
scopes = "User.Read Chat.ReadWrite ChatMessage.Send offline_access"

[profiles.locked-down]
auth_app = "byo"
client_id = "11111111-1111-1111-1111-111111111111"
tenant_id = "22222222-2222-2222-2222-222222222222"
scopes = "User.Read People.Read Files.Read.All offline_access"

Tokens are stored in the OS keyring, not in this file.

The scopes field is optional. It pins the delegated Microsoft Graph scope string for that profile. CLI --scopes and TEAMS_CLI_SCOPES override it for one command; otherwise the profile value is used before the built-in defaults.