sms-monitor

Polls Android SMS inbox via Termux:API and sends AI-generated replies.

10|2|Updated Jul 9, 2026
One-click install
npx skills add https://github.com/xvxv-stack7/android-claude-agent --skill sms-monitor-xvxv-stack7
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sms-monitor
Source: https://github.com/xvxv-stack7/android-claude-agent/tree/main/skills/android-monitor/sms
Command: npx skills add https://github.com/xvxv-stack7/android-claude-agent --skill sms-monitor-xvxv-stack7

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets an AI assistant receive and respond to SMS messages on an Android phone, turning a spare SIM card into a phone number the AI can converse through without manual forwarding. ## Core Features & Use Cases - Inbox Polling: Reads recent SMS messages as clean JSON using termux-sms-list, with timestamp-based deduplication so each message is processed once. - Automated Replies: Combines a cron polling script, a trigger file, and Claude Code CronCreate to detect new messages, generate natural-language replies, and send them via termux-sms-send. - Use Case: Give the AI a second SIM's number; when a friend texts that number, the AI reads the message within a minute, writes a short reply, and sends it back automatically. ## Quick Start Set up SMS monitoring on this phone so you can read incoming texts and reply to them automatically.

Frequently Asked Questions about sms-monitor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read SMS messages from Termux on Android?▼

Use termux-sms-list from the Termux:API app, which returns recent inbox messages as a JSON array with number, body, and received timestamp. Grant SMS permission to Termux:API in Android settings first.

How to send SMS from the command line on Android?▼

Run termux-sms-send with the -n flag for the recipient number and -m for the message body. On dual-SIM devices, set a default SMS SIM via adb settings or pass the correct subscription ID with -s.

Does termux-sms-list work with any Termux:API version?▼

No, this workflow requires Termux:API version 1.30 exactly, because other versions have incompatible SMS command signatures. Install it from F-Droid as package com.termux.api.

Why does termux-sms-send show a SIM selection popup?▼

Dual-SIM devices prompt for SIM choice unless defaults are set via adb shell settings for multi_sim_sms and multi_sim_sms_prompt. On vivo/BBK devices the popup may persist even after these settings, which is a known unresolved issue.

Can this approach receive MMS or RCS messages?▼

No, termux-sms-list only accesses the standard SMS inbox. MMS is not accessible, and RCS/Chat messages live in the proprietary Google Messages database rather than the SMS store.

What are the limitations of polling-based SMS detection?▼

Android emits no shell-visible events for incoming SMS, so polling is required and 60-second cron is the practical floor. Timestamps are minute-level, so multiple messages in the same minute can cause detection gaps.