Skip to content
pubscout

android_sms_reader

0.0.7, released 3 weeks ago by stackobea.com

A Flutter plugin to read, filter, search, and stream SMS messages on Android.

WASM-ready
$ flutter pub add android_sms_reader
Source repository

What it does

Allows Flutter applications running on Android to fetch SMS messages from inbox, sent, and draft folders with pagination and search. It also supports checkpoint-based incremental inbox reads and real-time streaming of incoming messages.

AI-written summary of version 0.0.7, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need to read or search SMS messages within an Android Flutter application.
  • You want to stream incoming SMS messages in real-time.
  • You require incremental inbox syncing using checkpoints.

Skip it when

  • You are targeting iOS or other non-Android platforms.
  • You cannot qualify for Google Play restricted SMS permissions.

Strengths

  • Supports pagination, filtering, and search by keyword or phone number.
  • Provides native checkpoint-based incremental inbox reading.
  • Includes real-time streaming of incoming SMS messages.

Weaknesses

  • Android only; throws MissingPluginException on other platforms.
  • Requires restricted Google Play permissions (READ_SMS, RECEIVE_SMS).

Setup

Kind
Plugin (native code)
Effort
Medium
Code generation
No
Direct dependencies
0

Add READ_SMS and RECEIVE_SMS permissions to AndroidManifest.xml and handle runtime permissions using a package like permission_handler.

import 'package:android_sms_reader/android_sms_reader.dart';

Future<void> demo() async {
  final messages = await AndroidSMSReader.fetchMessages(
    type: AndroidSMSType.inbox,
    start: 0,
    count: 50,
    query: 'OTP',
  );

  AndroidSMSReader.observeIncomingMessages().listen((sms) {
    print('Received: \${sms.body}');
  });
}

Alternatives

Packages that do the same job and could replace android_sms_reader.