Kobiton for Claude Code

Kobiton for Claude Code is a plugin that connects Claude Code to the Kobiton mobile testing platform. You can manage devices, upload apps, run automation tests, and review results using natural language commands.

Join our Discord Kobiton Cloud

For the best experience, use Claude Code instead of Claude.ai. MCP integration in Claude.ai may be unreliable.

Overview

Kobiton for Claude Code adds tools and a guided automation workflow to Claude Code. You can perform common mobile testing tasks without switching between the terminal, the Kobiton portal, and local test scripts.

Example:

Upload my-app.apk and run my login test on an available Pixel device

Claude will:

  • Upload the app

  • Select an available device

  • Parse capabilities from your script

  • Run the test

  • Return results and artifacts

Get started

Open a workspace folder

Before using Claude Code, open a command-line tool on your machine:

  • macOS: Terminal

  • Windows: PowerShell or Command Prompt

Create a folder:

mkdir kobiton-project

You can create this folder anywhere, for example in your Documents directory.

Next, start Claude Code from that location:

cd kobiton-project
claude

Claude Code uses this folder as its workspace.

If no folder is defined, Claude Code cannot install or use plugins and will prompt you to select one.

Install the plugin

Once Claude Code starts in your Terminal, run the following commands one at a time in that window:

/plugin marketplace add kobiton/automate

then

/plugin install automate@kobiton

Both steps are required and must be run separately.

Authentication

Authentication occurs the first time you use the plugin.

Run a command such as:

Show available Android devices

Claude Code will then prompt you to sign in through your browser.

You can authenticate using OAuth or an API key.

OAuth (recommended)

When you first use the plugin, a browser window opens. Sign in with your Kobiton credentials. Claude stores tokens automatically.

API key

Generate an API key in Kobiton Portal > Settings > API Keys. Then set:

export KOBITON_AUTH="Basic $(echo -n 'username:api-key' | base64)"

Update .mcp.json to include the Authorization header.

OAuth and API key authentication cannot be used together. Use one method at a time.

Run a command

After authentication, enter commands in Claude Code using natural language.

Show available Android devices
Show results for session 12345
Upload app.apk and run tests/smoke_test.js

Capabilities

Devices

  • View available devices

  • Check device status

  • Reserve and release devices

Apps

  • Upload Android and iOS apps

  • View uploaded apps

  • Get app details

Test execution

The run-automation-suite skill guides you through the full test lifecycle:

  • Upload or select an app

  • Select a device

  • Parse capabilities from your script

  • Run the test

  • Return results and artifacts

Supported languages:

Language Extension Command

Node.js

.js

node <script> <udid>

Python

.py

python <script> <udid>

.NET

.cs / .csproj

dotnet test

Java

.java

mvn test or java -cp …​

Sessions

  • View active and past sessions

  • Get logs, screenshots, and videos

  • Stop running sessions

Example commands

Devices

Show available Android devices
Check if Galaxy S23 is available
Reserve Pixel 6 for 60 minutes

Apps

Show uploaded Android apps
Upload resources/apps/GS.apk

Tests

Run tests/smoke_test.js on a Pixel device

Sessions

Show running sessions
Get details for session 12345
Download logs from last failed session

Tool Reference

Use this section as a reference for available tools and their behavior.

Devices

Tool Description Read-only

listDevices

List available devices filtered by platform, availability, device group, name, or UDID

Yes

getDeviceStatus

Get real-time status of a specific device (availability, battery, connection state)

Yes

reserveDevice

Reserve a device for exclusive use during testing

No

terminateReservation

Release a reserved device

No (destructive)

Sessions

Tool Description Read-only

listSessions

List test sessions filtered by status, device, or platform

Yes

getSession

Get session details: commands executed, capabilities, metadata, test results

Yes

getSessionArtifacts

Get download URLs for video recording, device logs, screenshots, test reports

Yes

terminateSession

Stop a running test session

No (destructive)

Apps

Tool Description Read-only

listApps

List uploaded app builds in your organization

Yes

uploadAppToStore

Upload an app to Kobiton Store (returns pre-signed URL for upload)

No

confirmAppUpload

Confirm an uploaded app so Kobiton creates the app record

No

getApp

Get app details and version history

Yes

Skills

Skill Description

run-automation-suite

Guided workflow: app upload → device selection → script parsing → execution → results

Troubleshooting

Claude keeps asking to open a folder

Open or create a folder in Claude Code before running plugin commands.

Browser does not open for login

Ensure a default browser is set and you are not in a restricted environment.

Device not found

The device may be unavailable. Filter for available devices.

Upload timeout

Large files or slow connections can cause timeouts. Retry the upload.

Session stuck

Terminate the session and run it again.

Authentication not recognized

Reload your shell and restart Claude Code.

Additional resources