Skip to main content
MCP server CX Codex

OBSBOT Tiny 2 Camera Control — Claude Code MCP server

OBSBOT Tiny 2 Camera Control is a Claude Code MCP server that manages OBSBOT Tiny 2 cameras over USB. It handles PTZ gimbal rotation, zoom levels, and focus.

MIT ★ 6 updated 2026-11-05

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env OBSBOT_LOG_FILE=<OBSBOT_LOG_FILE> --transport stdio obsbot-tiny-2-camera-control -- npx -y obsbot-mcp
Open on GitHub

What OBSBOT Tiny 2 Camera Control does

The server links an assistant to OBSBOT Tiny 2 hardware over standard UVC/USB connections. Vendor SDKs are not required. It also interfaces with OBSBOT Tail 2 network cameras through HTTP and WebSockets. Agents receive 35 control tools on Windows and macOS for pan, tilt, zoom, autofocus, and frame capture. Launching with --debug adds the low-level probe tool obsbot_debug_probe.

When multiple cameras are connected, obsbot_devices scans their serial numbers and availability states. Individual actions accept a camera serial argument. The obsbot_aim_at_pixel tool centers the lens on designated pixel coordinates directly from an acquired frame.

Linux environments carry distinct restrictions. The obsbot_gimbal_move_speed action is disabled, and obsbot_gimbal_position reports the last commanded angle rather than live telemetry.

What it helps with

  • adjust gimbal pan, tilt, and roll angles
  • center the camera view onto specific image pixel coordinates
  • inspect live zoom, focus, and exposure parameters
  • switch the hardware between awake and sleep positions

Example prompts for the agent

  • Pan the camera 20 degrees left and tilt down by 10 degrees
  • Check the camera status and report the current zoom percent
  • Put the camera into sleep mode

How to install OBSBOT Tiny 2 Camera Control

Platform CLI

claude mcp add --env OBSBOT_LOG_FILE=<OBSBOT_LOG_FILE> --transport stdio obsbot-tiny-2-camera-control -- npx -y obsbot-mcp

Replace <…> with your own values

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about OBSBOT Tiny 2 Camera Control

How do I install OBSBOT Tiny 2 Camera Control in Claude Code?

Run claude mcp add obsbot-mcp -- npx -y obsbot-mcp. If file logging is required, pass the environment variable: claude mcp add --env OBSBOT_LOG_FILE=<OBSBOT_LOG_FILE> --transport stdio obsbot-tiny-2-camera-control -- npx -y obsbot-mcp.

What does OBSBOT Tiny 2 Camera Control do?

It provides tools to direct pan, tilt, zoom, autofocus, and power modes on OBSBOT Tiny 2 cameras via USB and OBSBOT Tail 2 over HTTP.

What limitations apply on Linux systems?

The speed movement tool obsbot_gimbal_move_speed is unavailable on Linux. In addition, obsbot_gimbal_position returns the last commanded angle rather than real-time hardware position telemetry.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open