communication
RingCentral CLI for Headless Automation
Use the RingCentral CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
6 functions 5 read 1 write Manual OAuth token auth
RingCentral CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The RingCentral CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# RingCentral CLI for Headless Automation
kosmokrator integrations:configure ringcentral --set access_token="$RINGCENTRAL_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call ringcentral.ringcentral_list_messages '{"messageType":"example_messageType","dateFrom":"example_dateFrom","dateTo":"example_dateTo","direction":"example_direction","readStatus":"example_readStatus","perPage":1,"page":1}' --jsonDiscovery Before Execution
Agents and scripts can inspect RingCentral docs and schemas before choosing a function.
kosmo integrations:docs ringcentral --json
kosmo integrations:docs ringcentral.ringcentral_list_messages --json
kosmo integrations:schema ringcentral.ringcentral_list_messages --json
kosmo integrations:search "RingCentral" --json
kosmo integrations:list --jsonUseful RingCentral CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
ringcentral.ringcentral_list_messages | Read | messageType, dateFrom, dateTo, direction, readStatus, perPage, page | List messages from the RingCentral message store. Supports filtering by type (SMS, Fax, VoiceMail), date range, read status, and direction. Returns paginated message records. |
ringcentral.ringcentral_get_message | Read | messageId | Get detailed information about a specific message in the RingCentral message store by its ID. Returns the full message record including sender, recipient, subject, and content. |
ringcentral.ringcentral_send_sms | Write | from, to, text | Send an SMS message via RingCentral. The "from" number must be a phone number assigned to the authenticated extension. The "to" number is the destination phone number. |
ringcentral.ringcentral_list_calls | Read | dateFrom, dateTo, direction, type, phoneNumber, perPage, page | List call log records for the authenticated RingCentral extension. Supports filtering by date range, direction, type, and phone number. Returns paginated call records with caller, receiver, duration, and result. |
ringcentral.ringcentral_list_contacts | Read | startsWith, perPage, page | List contacts from the RingCentral personal address book. Supports filtering by name prefix and pagination. Returns contact records with names, phone numbers, and email addresses. |
ringcentral.ringcentral_get_current_user | Read | none | Get information about the currently authenticated RingCentral extension. Returns extension ID, name, status, phone numbers, and account details. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.