Phone MCP

🚀 ADB Installation and Contact Creation Tool

This project provides a guide on installing ADB (Android Debug Bridge) and a tool to create contacts on Android devices via ADB using Python scripts.

🚀 Quick Start

📦 Installation

Download and Install ADB

1. Download ADB: Visit the Android Developers website to download the ADB toolkit suitable for your operating system.
2. Extract the File: Extract the downloaded toolkit to your computer. Make sure the platform-tools folder contains all necessary executable files (e.g., adb.exe).
3. Add Environment Variables:
   • Windows: Add the platform-tools path to the system path variables.
   • macOS/Linux: Add platform-tools to the ~/.bashrc or ~/.zshrc file.

Connect the Device

1. Enable Debugging Mode:
   • On your Android device, navigate to the following settings:

     Settings -> System -> About Phone -> Software Information -> Tap "Build number" seven times -> Developer options
     

   • Enable "USB debugging" and "Allow network traffic for emulators".
2. Connect the Device:
   • Connect your Android device to your computer using a USB cable.
   • Open a command-line tool (e.g., CMD on Windows or Terminal on macOS/Linux).
   • Enter the following command to check if the device is properly connected:

     adb devices
     

   • If your device is listed, the connection is successful.

Verify the Installation

1. Run an Example Command:
   • Enter the following command in the command-line tool to verify that ADB is working properly:

     adb shell pm list packages
     

   • If the list of applications on the device is output, ADB is correctly installed and configured.

✨ Features

This tool allows you to easily create contacts on Android devices via ADB.

💻 Usage Examples

Basic Usage

Run the script directly:

python create_contact.py

This will create a default contact with the following information:

• Account Name: "Your Account Name"
• Account Type: "com.google"

Advanced Usage

You can provide a custom account name and type using a JSON string:

python create_contact.py '{"account_name": "your_account", "account_type": "com.google"}'

Output

The script outputs a JSON object containing the following:

• success: A boolean indicating whether the operation was successful.
• message: Any output or error message from the command.

Example Output (Success)

{"success": true, "message": ""}

Error Handling

• If ADB is unavailable or the device is not connected, the script will return an error.
• Invalid JSON input will result in an error message.
• Any ADB command errors will be captured and recorded in the message field.

Important Note

• Ensure that your Android device is connected and authorized for ADB use.
• The device screen should be unlocked.
• Some devices may require additional permissions to create contacts.

🔧 Technical Details

Python Script Example

The following is a Python script for creating contacts via ADB:

import os

def create_contact(account_name, account_type):
    # Start the add contact activity
    os.system("adb shell am start -a android.intent.action.ADD_VIA_ADDRESS")
    
    # Wait for the device to respond (adjust the time as needed)
    import time
    time.sleep(2)
    
    # Enter the account name
    os.system(f"adb shell input text {account_name}")
    
    # Set the account type
    os.system(f"adb shell content insert --uri content://com.android.contacts/contacts --values name={account_type}")
    
    # Save the contact
    os.system("adb shell keyevent 66")  # Press the "OK" key

# Example usage
create_contact("your_account", "com.google")

Code Explanation

1. Start the Add Contact Activity:

   os.system("adb shell am start -a android.intent.action.ADD_VIA_ADDRESS")
   

2. Enter the Account Name:

   os.system(f"adb shell input text {account_name}")
   

3. Set the Account Type:

   os.system(f"adb shell content insert --uri content://com.android.contacts/contacts --values name={account_type}")
   

4. Save the Contact:

   os.system("adb shell keyevent 66")
   

Extended Explanation

• Modify the Account Type: You can replace the account_type parameter with other account types, such as "com.yahoo" or "com.microsoft".
• Customize the Input Logic: Adjust the input time and commands as needed.
• Batch Create Contacts: You can write a loop script to add multiple contacts in batches.

📚 Documentation

Frequently Asked Questions

1. How to verify that ADB is working properly? Run the following command in the command-line tool:

adb devices

If your device is listed, ADB is correctly configured.

2. What if the device does not appear in the adb devices list?

• Ensure that USB debugging is enabled on the device.
• Try reconnecting the device.
• Check if the correct USB driver is installed.

3. How to solve ADB permission issues? Run the following command in the command-line tool:

adb shell pm grant com.android.contacts.permission.WRITE_CONTACTS

4. What if the script fails to create a contact? Check if you have sufficient device permissions and ensure that the account type is correct.

📄 License

No license information provided.

In summary, you can automate the management of contacts on Android devices through ADB and Python scripts. This article details the installation and configuration methods of ADB and provides an example of using a Python script to automatically add contacts. We hope this information is helpful to you!