connected apps.md

connected-apps

Apps and MCP clients connected with OAuth. The machinemail connected-apps commands: arguments, flags, examples and the API routes they call.

Source: https://machinemail.dev/docs/cli/commands/connected-apps

Apps and MCP clients connected with OAuth.

Command Summary
connected-apps delete Disconnect app
connected-apps list List connected apps

Every command also takes the global flags.

connected-apps delete

Disconnect app.

Also: machinemail connected-apps rm.

Revokes the grant: its refresh token and every access token issued from it stop working immediately (401 on /mcp and /v0). Returns the grant as it was. Requires an organization-scoped credential with api_key_delete.

machinemail connected-apps delete <grant-id> [flags]

Arguments

Field Type Description
<grant-id> string ID of the grant (oag_...).

Examples

machinemail connected-apps delete <grant-id>

API

connected-apps list

List connected apps.

Also: machinemail connected-apps ls.

Apps and MCP clients people in the organization connected with OAuth. Requires an organization-scoped credential with api_key_read; pod, inbox and sandbox credentials get 403.

machinemail connected-apps list [flags]

Flags

Field Type Description
--limit <n> integer Maximum number of items to return. Default 50, maximum 500; larger values are capped. Default: 50.
--page-token <value> string next_page_token from the previous page.
--ascending boolean Sort oldest first.
--all boolean Follow next_page_token and return every page.

Examples

machinemail connected-apps list
machinemail connected-apps list --all --json | jq '.oauth_grants | length'

API