A Flutter plugin to retrieve and manage contacts on Android and iOS devices.


To use this plugin, add flutter_contacts_plugin as a dependency in your pubspec.yaml file.

Make sure you add the following permissions to your Android Manifest:

<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.WRITE_CONTACTS" />

On iOS, make sure to set NSContactsUsageDescription in the Info.plist file

<string>This app requires contacts access to function properly.</string>


// Import package
import 'package:flutter_contacts_plugin/flutter_contacts_plugin.dart';

// Get all contacts
Iterable<Contact> contacts = await FlutterContactsPlugin.getContacts();

// Get contacts matching a string
Iterable<Contact> johns = await FlutterContactsPlugin.getContacts(query : "john");

// Add a contact
// The contact must have a firstName / lastName to be successfully added
await FlutterContactsPlugin.addContact(newContact);

//Delete a contact
await FlutterContactsPlugin.deleteContact(contact);