Android-Preference-Editor MCP Server

Name: Android-Preference-Editor MCP Server
Author: charlesmuchene

@charlesmuchene

Repository Homepage

About Android-Preference-Editor MCP Server

Preference Editor MCP server

#android #ai #mcp #shared-preferences #datastore-preferences #agentic-ai #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "pref-editor-mcp-server": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "npm",
        "run",
        "dev"
      ]
    }
  }
}

Tools

Changes the value of an existing preference

Delete an existing preference

Adds a new preference given the name, value, and type

Reads all user preferences in a file

Lists connected Android devices

Lists apps installed on the device

Lists preference files for an app

Overview

What is Android Preference Editor MCP Server?

An MCP server that enables editing Android user preferences in real time using natural language commands. It connects with MCP clients (e.g., Claude Desktop, VS Code, GitHub Copilot) and uses the Android Preference Editor library and Android adb to manage preferences on connected devices.

How to use Android Preference Editor MCP Server?

Install via Docker or npx, then add the server configuration to your MCP client’s config file (e.g., mcp.json for VS Code or GitHub Copilot, claude_desktop_config.json for Claude Desktop). The server provides tools like change_preference, delete_preference, add_preference, read_preferences, devices, list_apps, and list_files.

Key features of Android Preference Editor MCP Server

Edit Android preferences with natural language commands
Change, delete, add, and read preference values
List connected Android devices
List apps installed on a device
List preference files for an app
Run via Docker or npx with no manual file editing

Use cases of Android Preference Editor MCP Server

Toggle a user preference like isVisited during development
Turn off an onboarding guide without opening configuration files
List all current user preference values for debugging
Create a timestamp preference with the current epoch time

FAQ from Android Preference Editor MCP Server

What are the system requirements?

Android adb (v1.0.41+) and Node.js 14+ or Docker are required.

How do I integrate with Claude Desktop?

Add the server to /Users/<username>/Library/Application Support/Claude/claude_desktop_config.json using the Docker or npx configuration provided in the README.

What tools are available?

The server exposes seven tools: change_preference, delete_preference, add_preference, read_preferences, devices, list_apps, and list_files.

Can I run it with Docker?

Yes, the server is available as a Docker image (charlesmuchene/pref-editor-mcp-server) and can be run with docker run -i --rm charlesmuchene/pref-editor-mcp-server.