- name
- ravi-inbox
- description
- 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).
Ravi Inbox
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)
# 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:
[{
"conversation_id": "1_+15559876543",
"from_number": "+15559876543",
"phone_number": "+15551234567",
"preview": "Your code is 847291",
"message_count": 3,
"unread_count": 1,
"latest_message_dt": "2026-02-25T10:30:00Z"
}]JSON shape — conversation detail:
{
"conversation_id": "1_+15559876543",
"from_number": "+15559876543",
"messages": [
{"id": 42, "body": "Your code is 847291", "direction": "incoming", "is_read": false, "created_dt": "..."}
]
}Email (verification links, confirmations)
# List email threads
ravi inbox email
# View a specific thread (all messages with full content)
ravi inbox email <thread_id>JSON shape — thread detail:
{
"thread_id": "abc123",
"subject": "Verify your email",
"messages": [
{
"id": 10,
"from_email": "noreply@example.com",
"to_email": "janedoe@example.com",
"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
ravi inbox sms | jq -r '.[].preview' | grep -oE '[0-9]{4,8}'Extract a verification link from email
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 5before checking. - Auto-contacts — Ravi automatically creates or updates contacts when you send or receive email/SMS. Use
ravi contacts searchto 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