Android-Preference-Editor MCP Server

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.

How can I test the server?

Use the MCP Inspector by running npx @modelcontextprotocol/inspector npm run start from the project directory.