Ravi inbox

Read incoming SMS or email messages — OTPs, verification codes, verification links, incoming mail. Do NOT use for sending email (use ravi-email-send) or managing credentials (use ravi-passwords or ravi-secrets).

Read SMS and email messages received at your Ravi identity. Use this after triggering verifications, 2FA, or when expecting incoming messages.

SMS (OTPs, verification codes)

bash

# List SMS conversations (grouped by sender)
ravi inbox sms

# View a specific conversation (all messages)
# conversation_id format: {phone_id}_{from_number}, e.g. "1_+15559876543"
ravi inbox sms "1_+15559876543"

JSON shape — conversation list:

json

[{
  "conversation_id": "1_+15559876543",
  "from_number": "[phone]",
  "phone_number": "[phone]",
  "preview": "Your code is 847291",
  "message_count": 3,
  "unread_count": 1,
  "latest_message_dt": "2026-02-25T10:30:00Z"
}]

JSON shape — conversation detail:

json

{
  "conversation_id": "1_+15559876543",
  "from_number": "[phone]",
  "messages": [
    {"id": 42, "body": "Your code is 847291", "direction": "incoming", "is_read": false, "created_dt": "..."}
  ]
}

Email (verification links, confirmations)

bash

# List email threads
ravi inbox email

# View a specific thread (all messages with full content)
ravi inbox email <thread_id>

JSON shape — thread detail:

json

{
  "thread_id": "abc123",
  "subject": "Verify your email",
  "messages": [
    {
      "id": 10,
      "from_email": "[e-mail]",
      "to_email": "[e-mail]",
      "subject": "Verify your email",
      "text_content": "Click here to verify: https://example.com/verify?token=xyz",
      "direction": "incoming",
      "is_read": false,
      "created_dt": "..."
    }
  ]
}

Quick Recipes

Extract an OTP code from SMS

bash

ravi inbox sms | jq -r '.[].preview' | grep -oE '[0-9]{4,8}'

Extract a verification link from email

bash

THREAD_ID=$(ravi inbox email | jq -r '.[0].thread_id')

ravi inbox email "$THREAD_ID" | jq -r '.messages[].text_content' | grep -oE 'https?://[^ ]+'

Important Notes

• Poll, don't rush — SMS/email delivery takes 2-10 seconds. Use sleep 5 before checking.
• Auto-contacts — Ravi automatically creates or updates contacts when you send or receive email/SMS. Use ravi contacts search to look up people you've interacted with.

Full API Reference

For complete endpoint details, request/response schemas, and parameters: Inbox | Messages

Related Skills

• ravi-email-send — Reply or forward emails you've read
• ravi-email-writing — Write professional replies with proper formatting and tone
• ravi-contacts — Look up a sender's name or details from their email/phone
• ravi-login — End-to-end signup/login workflows that use inbox for OTP extraction
• ravi-feedback — Report inbox delivery issues or suggest improvements