NexusAndroid

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/pironjulien-nexus-android

About

Use cases: mobile-development, workflow-automation

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

2 read · 2 write · 0 delete · 14 not yet classified

Secrets

None asked for

Install scripts

Not scanned yet

Runs as

Python package

Tools (18)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• act

  Gestures on the phone, in order (stops at the first error), then the updated screen. Steps: tap, long_press, double_tap, type (any text, accents and emoji included; target = field to tap first; non-ASCII is pasted through the clipboard, which is then given back to the user unchanged), clear, key (back, home, recent, delete, ctrl+a, arrows, tab, volume; enter and other KEYCODE_*: confirm=true + accord, alone in their step), scroll (direction = reading direction: down to see what follows), swipe (target → to), drag (held, moved, dropped: target → to), zoom (direction in|out, target = center, amo…

• apps

  Phone apps. info: version, install and update dates, source, enabled. stop: force-stop (no data lost, the app starts again when opened). clear: delete all its data. uninstall: remove it (a system app is only hidden for the user; restore brings it back by its full package name). install: an .apk from the PC (path; sensitive folders refused), as an update keeping its data when already there. clear, uninstall and install: confirm=true, only on the user's explicit order. Never for the system's own parts (phone, interface, Settings, store, keyboard, Google services), nor clear/uninstall of banking,…

• capture

  Save the phone screen as a file on the PC, e.g. to show a problem to a support service: folder dest (default ~\Downloads\Telephone, same folder rules as files pull), never overwrites; the response gives the path. screenshot: full resolution PNG (JPEG if name ends in .jpg), security codes blacked out as on look images. record: video of the next `seconds` (default 30, max 180), then saved. start: begins a video and returns at once so gestures can go on (stops by itself after `seconds`, default and max 180); stop: ends it and saves it. Video: MP4, 720p, 4 Mbit/s, no sound, one at a time. Security…

• checkup

  Phone checkup: system, security patch, battery, storage, memory, apps outside official stores, wireless debugging, accessibility. clean=true also clears app caches (no data loss).

• clipboard

  The phone's clipboard. read: its text (security codes masked; a lone code, password or token is never shown), or says it is empty or not text. write: puts `text` in it (accents and emoji allowed, 256 KB at most), without pasting it anywhere; it replaces what the user had copied.

• draft

  Prepare a reply without sending it: opens the conversation with the text already written (accents allowed). to: address book name ("Alice"), number (06…, +33…, 36179: digits alone are a number) or conversation number in brackets "[N]". app: sms (SMS/RCS) or whatsapp. Sending: only if the user explicitly says "send" for THIS draft, then act(steps=[{"do":"tap","target":"Send","confirm":true,"accord":"<token>"}]) with the token returned here for this exact draft (any change to it voids the token) and check on the image that it went out.

• files

  Files in the phone's shared storage (/sdcard: DCIM/Camera for photos, Download, Documents…). list: folder contents, most recent first (default /sdcard/Download). pull: copies path from the phone to the PC (dest, default ~\Downloads\Telephone; never overwrites). push: puts the PC file path into the phone folder dest (default /sdcard/Download; refused if it already exists). Nothing is ever deleted. PC side: Downloads, Documents, Desktop, Pictures and Videos are free; elsewhere confirm=true (the user's explicit order for that path); keys, secrets (.ssh, .env…) and Windows startup never.

• functions

  Structured actions that apps expose to assistants (Android AppFunctions): alarms, timers and stopwatch, reminders, notes, calendar events, contacts, gallery, files, calls… on Samsung and Google apps, run directly without the screen (works even with the phone locked). list: the apps and their functions (app: one app). run: app (package or part of its name), function (name from list, e.g. findAlarms), params as the app expects them: {"findAlarmsParams": {}}; when a field is missing, the app's error names it. Reading is free; creating or updating changes the user's data (do it on their order); de…

• info

  Read-only. location: last known position (accuracy, age, Maps link). calls: recent calls (incoming, outgoing, missed). contacts: numbers for a name (query). calendar: events of the next `days` days.

• launch

  Open an app by package name (com.whatsapp) or a fragment of it ("whatsapp", "maps"), then show it. Precise screen: action (android.settings.WIFI_SETTINGS, android.intent.action.VIEW…) and/or data (URI or deep link), extras {name: string, integer or boolean}; app then limits the target to that app. The target is resolved first, then reported with the new foreground. Calling, sending or paying directly (CALL, auto-send extras, payment actions and links): confirm=true, set only on the user's explicit order for this intent, plus accord=<token> returned for THIS exact intent once the user said yes …

• logs

  Android logs (logcat), to understand why an app crashed or misbehaves; newest last, about 30,000 characters at most. crash: crashes grouped one per block (time, package, Java exception and its "Caused by", first app frames; native crashes: signal, cause, backtrace). anr: "app not responding" events (Android's drop box, kept for days, and the recent event log) with their reason. recent: last `lines` log lines (default 200, max 2000). app: package or part of its name, as in launch (an uninstalled app: its full package name); for recent, its running processes, those Android started earlier, and l…

• look

  See the phone screen: numbered elements [N] (role, text, states, center @x,y), and an image when needed. show: auto (default, text first: the list alone; the image is joined when the screen has no readable element), both (list and image), image, elements, none. query: list only the elements containing this text. region [x1,y1,x2,y2]: zoom (pixels of the last full image). marks (show=both): [N] numbers drawn on the image, with a thin outline of each element (auto = all when few, else unnamed elements only; all; none). Unreadable UI tree: the image is not sent (codes not masked), unless confirm=…

• map

  Map of the whole phone, read without touching the screen. find (default): where something is set, from the user's words (query="read notifications on the Buds"; titles are in the phone's language, accents optional) → path from Settings, current value, and how to open it directly (launch(action=…) or map(action="open", target=…, key=…), the row highlighted). Built from the phone's own Settings app (every screen, French titles) plus the app screens noted on screen; rebuilt by itself after an update. open: target (package/activity from find), optional key to highlight a row. snapshot: saves the p…

• messages

  The phone's SMS and RCS messages. No argument: recent conversations [N] with contact, date, unread count. conversation=N, or contact="Alice" (address book name): the last `limit` messages (up to 500), with the `images` most recent photos attached (0 for none; videos and files are only mentioned). before: ISO date given at the end of a response ("older: …") to read the next, older page. Response limited to about 60,000 characters, cut between two messages.

• notifications

  Notifications shown on the phone (app, time, title, text), most recent first; security codes masked. all=true: also the ongoing ones (running services). For dismissed notifications, Android keeps only the app name.

Signals

Stars

1

Forks

0

Open issues

0

Weekly downloads

1,519

Last commit

Oct 24, 2026 (4 days ago)

Last release

Oct 26, 2026 (2 days ago)

Last package publish

Oct 24, 2026 (4 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.pironjulien/nexus-android

Version

0.14.1

Auth

No auth

Packages

pypi nexus-android

License

MIT

Repository

github.com/pironjulien/NexusAndroid

Website

julienpiron.fr/nexusandroid/

First seen

Oct 24, 2026

Last checked

Oct 26, 2026

Source

Official MCP Registrygithub-graphql