android_send_key_event

Simulate hardware button presses on Android devices, such as HOME, BACK, or ENTER, for automated testing and remote control.

Instructions

Send a key event to the Android device (e.g., KEYEVENT_HOME, KEYEVENT_BACK, KEYEVENT_ENTER)

Input Schema

TableJSON Schema

Name	Required	Description	Default
`keyCode`	Yes	Key event code (e.g., KEYEVENT_HOME, KEYEVENT_BACK, KEYEVENT_ENTER, 3 for HOME, 4 for BACK). Can be key name or numeric code.
`deviceSerial`	No	Specific device serial number to target (optional)

Implementation Reference

src/handlers.ts:678-694 (handler)

The main handler function for the 'android_send_key_event' tool. It extracts arguments, calls the ADB wrapper's sendKeyEvent method, and returns a success message or throws an error.

export async function handleSendKeyEvent(adb: ADBWrapper, args: SendKeyEventArgs): Promise<{ content: Array<{ type: string; text: string }> }> {
  const { keyCode, deviceSerial } = args;

  try {
    await adb.sendKeyEvent(keyCode, deviceSerial);
    return {
      content: [
        {
          type: 'text',
          text: `Key event sent: ${keyCode}`,
        },
      ],
    };
  } catch (error) {
    throw new Error(`Failed to send key event: ${error instanceof Error ? error.message : String(error)}`);
  }
}

src/index.ts:398-415 (schema)

The input schema and tool metadata definition for 'android_send_key_event' used in tool listing and validation.

{
  name: 'android_send_key_event',
  description: 'Send a key event to the Android device (e.g., KEYEVENT_HOME, KEYEVENT_BACK, KEYEVENT_ENTER)',
  inputSchema: {
    type: 'object',
    properties: {
      keyCode: {
        type: 'string',
        description: 'Key event code (e.g., KEYEVENT_HOME, KEYEVENT_BACK, KEYEVENT_ENTER, 3 for HOME, 4 for BACK). Can be key name or numeric code.',
      },
      deviceSerial: {
        type: 'string',
        description: 'Specific device serial number to target (optional)',
      },
    },
    required: ['keyCode'],
  },
},

src/index.ts:502-503 (registration)
The switch case registration that dispatches calls to the 'android_send_key_event' handler function.
```
case 'android_send_key_event':
  return await handleSendKeyEvent(this.adb, args as any);
```

src/adb-wrapper.ts:398-401 (helper)

Supporting utility method in ADBWrapper class that executes the actual ADB 'shell input keyevent' command to send the key event to the device.

async sendKeyEvent(keyCode: string, deviceSerial?: string): Promise<void> {
  const device = await this.getTargetDevice(deviceSerial);
  await this.exec(['shell', 'input', 'keyevent', keyCode], device);
}

src/handlers.ts:673-676 (schema)
TypeScript interface defining the input arguments for the send key event handler.
```
interface SendKeyEventArgs {
  keyCode: string;
  deviceSerial?: string;
}
```

Android MCP Server