# Frida Mobile MCP

Frida Mobile MCP hands an AI agent dynamic instrumentation for Android and iOS through Frida 17: hooks, call tracing, memory secret hunting, SSL pinning bypass.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 21 repo stars
- Author: monkeywave
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/monkeywave/frida-mobile-mcp
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/frida-mobile-mcp

## What it does

The server exposes 71 tools on top of Frida 17. High-level calls sort out the device and the session: launch an app suspended, resume it, hook a Java, ObjC or native method, sweep memory for secrets. Underneath sit the primitives — spawn, attach, module and symbol lists, address lookup, memory dumps.

Addresses stay in `module+0xoffset` form, the notation Ghidra and IDA use, so a finding from a static tool lands in a live process without arithmetic. Results come wrapped in an evidence envelope with `evidence_id`, `limitations` and `coverage`. Frida 17 took the Java and ObjC bridges out of the runtime, so both ship inside the package; `validate_script` also points out calls that break in 17 and names the replacement.

Node.js 22.12 or newer is the floor, along with a device or emulator on frida-server 17.x. The major version must line up with the bundled frida-node 17.24.3, otherwise attach fails, and `frida-mobile-mcp doctor` prints both versions and flags a mismatch. `pip install friTap` is optional for `capture_tls`; without it the pinned agent is fetched on first use.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `FRIDA_DEVICE_ID`, `FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS`, `FRIDA_MCP_MEMORY_WRITE`, `FRIDA_MCP_REMOTE`, `FRIDA_MCP_SCHEMA_PROFILE`, `FRIDA_MCP_MAX_RESPONSE_CHARS`, `FRIDA_MCP_HTTP_TOKEN`, `FRIDA_MCP_RUNTIME`, `FRIDA_MCP_DEBUG`, `FRIDA_MCP_BRIDGES_DIR` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env FRIDA_DEVICE_ID=<FRIDA_DEVICE_ID> --env FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS=<FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS> --env FRIDA_MCP_MEMORY_WRITE=<FRIDA_MCP_MEMORY_WRITE> --env FRIDA_MCP_REMOTE=<FRIDA_MCP_REMOTE> --env FRIDA_MCP_SCHEMA_PROFILE=<FRIDA_MCP_SCHEMA_PROFILE> --transport stdio frida-mobile-mcp -- npx -y frida-mobile-mcp
```
Replace <…> with your own values. 8 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add frida-mobile-mcp --env FRIDA_DEVICE_ID=<FRIDA_DEVICE_ID> --env FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS=<FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS> --env FRIDA_MCP_MEMORY_WRITE=<FRIDA_MCP_MEMORY_WRITE> --env FRIDA_MCP_REMOTE=<FRIDA_MCP_REMOTE> --env FRIDA_MCP_SCHEMA_PROFILE=<FRIDA_MCP_SCHEMA_PROFILE> -- npx -y frida-mobile-mcp
```
Replace <…> with your own values. 8 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "frida-mobile-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "frida-mobile-mcp"
            ],
            "env": {
                "FRIDA_DEVICE_ID": "<FRIDA_DEVICE_ID>",
                "FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS": "<FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS>",
                "FRIDA_MCP_MEMORY_WRITE": "<FRIDA_MCP_MEMORY_WRITE>",
                "FRIDA_MCP_REMOTE": "<FRIDA_MCP_REMOTE>",
                "FRIDA_MCP_SCHEMA_PROFILE": "<FRIDA_MCP_SCHEMA_PROFILE>"
            }
        }
    }
}
```
Replace <…> with your own values. 8 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "frida-mobile-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "frida-mobile-mcp"
            ],
            "env": {
                "FRIDA_DEVICE_ID": "<FRIDA_DEVICE_ID>",
                "FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS": "<FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS>",
                "FRIDA_MCP_MEMORY_WRITE": "<FRIDA_MCP_MEMORY_WRITE>",
                "FRIDA_MCP_REMOTE": "<FRIDA_MCP_REMOTE>",
                "FRIDA_MCP_SCHEMA_PROFILE": "<FRIDA_MCP_SCHEMA_PROFILE>"
            }
        }
    }
}
```
Replace <…> with your own values. 8 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e FRIDA_DEVICE_ID=<FRIDA_DEVICE_ID> -e FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS=<FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS> -e FRIDA_MCP_MEMORY_WRITE=<FRIDA_MCP_MEMORY_WRITE> -e FRIDA_MCP_REMOTE=<FRIDA_MCP_REMOTE> -e FRIDA_MCP_SCHEMA_PROFILE=<FRIDA_MCP_SCHEMA_PROFILE> frida-mobile-mcp npx -y frida-mobile-mcp
```
Replace <…> with your own values. 8 more environment variables are in the server README

## When to use it
- hook a Java method and read its arguments
- pull secrets out of memory and keep them as friTap patterns
- bypass SSL pinning and capture TLS keys
- walk the UI and measure reachability coverage
- carry an address from Ghidra into a running process

## Example prompts
- Launch the app and list the loaded classes with their methods
- Hook `com.example.Login.check` and print the arguments
- Dump memory at `libnative.so+0x1a2c` and show what is there

## Similar
- [frida-17](https://affpapa.org/en/nevibecode/skills/frida-17.md) — skill · 2900 installs
- [rev-frida](https://affpapa.org/en/nevibecode/skills/rev-frida.md) — skill · 2300 installs
- [17-mobile-security](https://affpapa.org/en/nevibecode/skills/17-mobile-security.md) — skill · ★ 71 repo stars
- [mobile-ssl-pinning-bypass](https://affpapa.org/en/nevibecode/skills/mobile-ssl-pinning-bypass.md) — skill · 4000 installs
- [mobile-pentester](https://affpapa.org/en/nevibecode/agents/mobile-pentester.md) — subagent · ★ 2482 repo stars
- [apkseep](https://affpapa.org/en/nevibecode/skills/apkseep.md) — skill · ★ 71 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
