apktool-mcp-server for Cursor: Setup & Config

What you can do with apktool-mcp-server in Cursor

Pick it for an Apktool-backed MCP workflow spanning manifest review, smali edits, and APK rebuilding.

• Read or update decoded resource files
• Rebuild an APK after permitted project modifications

Before you start: apktool-mcp-server in Cursor

• Python 3.10 or later
• uv
• Apktool installed and available in the environment
• A local project checkout or release download

Uses the Cherry Studio stdio example. Replace the project-directory placeholder. The README offers uv pip install httpx fastmcp if dependencies need manual installation.

apktool-mcp-server Cursor configuration

1. Choose Cursor configuration scope

   For apktool-mcp-server, open Project: .cursor/mcp.json User: ~/.cursor/mcp.json. Merge into mcpServers at project or user scope.

2. Add apktool-mcp-server to Cursor

   Use the apktool-mcp-server entry below in mcpServers. Keep apktool-mcp-server's documented stdio connection fields and your other Cursor entries.

3. Check apktool-mcp-server in Cursor

   apktool-mcp-server: Enable in Cursor’s MCP settings; inspect tools.

{
  "mcpServers": {
    "apktool-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/apktool-mcp-server",
        "run",
        "apktool_mcp_server.py"
      ],
      "env": {}
    }
  }
}

apktool-mcp-server tools available to Cursor

apktool-mcp-server's stored tool list documents 13 tools; compare it with Cursor's connected tool list, because the stored list is not a live check.

build_apk

Find build_apk under apktool-mcp-server in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Build an APK from a decoded Apktool project.

get_manifest

Find get_manifest under apktool-mcp-server in Cursor's MCP settings; inspect its arguments when the agent requests a call.

get_apktool_yml

Find get_apktool_yml under apktool-mcp-server in Cursor's MCP settings; inspect its arguments when the agent requests a call.

list_smali_directories

Find list_smali_directories under apktool-mcp-server in Cursor's MCP settings; inspect its arguments when the agent requests a call.

list_smali_files

Find list_smali_files under apktool-mcp-server in Cursor's MCP settings; inspect its arguments when the agent requests a call.

get_smali_file

Find get_smali_file under apktool-mcp-server in Cursor's MCP settings; inspect its arguments when the agent requests a call.

modify_smali_file

Find modify_smali_file under apktool-mcp-server in Cursor's MCP settings; inspect its arguments when the agent requests a call.

list_resources

Find list_resources under apktool-mcp-server in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Enumerate decoded resources, optionally by type.

get_resource_file

Find get_resource_file under apktool-mcp-server in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Read a selected decoded resource.

modify_resource_file

Find modify_resource_file under apktool-mcp-server in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Change a selected resource file.

search_in_file

Find search_in_file under apktool-mcp-server in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Find a pattern in files matching specified extensions.

clean_project

Find clean_project under apktool-mcp-server in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Clean a project before rebuilding.

decode_apk

Find decode_apk under apktool-mcp-server in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Decode an APK into resources and smali code with Apktool.

apktool-mcp-server: full stored tool descriptions

Troubleshooting apktool-mcp-server in Cursor

• Cursor must find uv for apktool-mcp-server. Enable the project/user entry in MCP settings and inspect its tools.
• apktool-mcp-server uses stdio here: Cursor must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: Requires a separately installed Apktool environment
• Known limitation: Client testing is reported for Claude Desktop, with others pending
• Known limitation: Usage is restricted to authorized analysis
• General Cursor troubleshooting lives in the /clients/cursor guide.

Frequently asked questions