Android Prefs MCP Server

Integrations

  • Provides tools for managing and editing Android application preferences, allowing users to view, toggle, and modify preferences on Android devices through the Android Debug Bridge (adb).

Android-Preference-Editor MCP Server

Overview

The Android-Preference-Editor MCP Server is a natural language interface designed for agentic applications to edit Android user preferences during app development. The implementation is based on the Android Preference Editor library. This server integrates seamlessly with MCP (Model Context Protocol) clients, enabling AI-driven workflows during Android app development. Using this MCP, you can give instructions like:

  • "Toggle the isVisited user preference"
  • "List the connected devices"
  • "What apps are installed on device?"
  • "Show me all the user preferences in the app"
  • "Add a lastTimeStamp user preference with the value of the current milliseconds since epoch"

Tools

NameDescription
change_preferenceChanges the value of an existing preference
delete_preferenceDelete an existing preference
add_preferenceAdds a new preference given the name, value and type.
devicesLists connected Android devices
list_appsLists apps installed on device
list_filesLists preference files for an app
read_preferencesReads all user preferences in a file

Demo

Toggle a user preferenceAvailable tools

See more demo screenshots here

Requirements

  • Android adb installed on the host system.

Integration with Claude Desktop

You can configure Claude Desktop to use this MCP server by adding the following in the claude_desktop_config.json configuration file.

{ "mcpServers": { "pref-editor": { "command": "npx", "args": ["@charlesmuchene/pref-editor-mcp-server"] } } }

Troubleshooting

You can troubleshoot problems by tailing the log file:

tail -f ~/Library/Logs/Claude/mcp-server-pref-editor.log

Integration with VS Code

To use the server with VS Code, you need to:

  1. Enable the agent mode tools. Add the following to your settings.json:
{ "chat.agent.enabled": true }
  1. Add the MCP Server configuration to your mcp.json or settings.json:
// .vscode/mcp.json { "servers": { "pref-editor": { "type": "stdio", "command": "npx", "args": ["@charlesmuchene/pref-editor-mcp-server"] } } }
// settings.json { "mcp": { "pref-editor": { "type": "stdio", "command": "npx", "args": ["@charlesmuchene/pref-editor-mcp-server"] } } }

For more information, see the VS Code documentation.

Installation

# Clone the repository git clone https://github.com/charlesmuchene/pref-editor-mcp-server.git cd pref-editor-mcp-server # Install dependencies and build npm install

Testing

You can use the MCP Inspector for visual debugging of this MCP Server.

npx @modelcontextprotocol/inspector npm run dev

License

See LICENSE

Contact

For questions or support, reach out via GitHub Issues.

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Android Prefs MCP Server

  1. Overview
    1. Tools
      1. Demo
        1. Requirements
          1. Integration with Claude Desktop
            1. Troubleshooting
          2. Integration with VS Code
            1. Installation
              1. Testing
                1. License
                  1. Contact

                    Related MCP Servers

                    View all related MCP servers

                    ID: 4nog2rc21n