communication
RingCentral CLI for Shell Scripts
Use the RingCentral CLI for shell scripts with headless JSON commands, schema discovery, credentials, and permission controls.
6 functions 5 read 1 write Manual OAuth token auth
RingCentral CLI for Shell Scripts
Call integration functions from shell scripts with stable JSON input and output.
Use shell scripts for small local automations that need one or more integration calls. 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 Shell Scripts
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.