huseyinstif / oculos

If it's on the screen, it's an API. Control any desktop app via REST + MCP. Rust.

Why this job: matched by what the repo talks about: mcp, api, control, desktop

Claude Code controlling Spotify through OculOS MCP

OculOS Dashboard — element tree inspector

Claude Code using OculOS MCP to open Calculator and compute 5×5

1 of 3

What it does

OculOS is a lightweight daemon that reads the OS accessibility tree and exposes every button, text field, checkbox, and menu item as a JSON endpoint. It works as a REST API for scripts, testing, and CI/CD — and as an MCP server for AI agents like Claude, Cursor, and Windsurf.

Get started

git clone https://github.com/huseyinstif/oculos.git
cd oculos
cargo build --release

You need: at-spi2-core — the accessibility bus and registry (sudo apt install at-spi2-core); xdotool — keyboard input (send-keys, keyboard scrolling) and window focus/close (sudo apt install xdotool). X11 only; on Wayland it reaches XWayland apps only.; wmctrl *(optional)* — graceful window close

Maintenance: Active; Last commit 45 days ago
Stars: 135; +1 this week
Licence: MIT; Allows business use
Downloads for: None listed; No release files
Latest version: None yet; No releases
Built with: Rust; 79% of the code

Is it looked after?

Contributors: 2; Last 90 days
Issues: 100% closed; 0 still open
Pull requests: 1 merged; 1 waiting
Releases: None; Never published

Similar repos

Repos similar to this one
Repo	Stars	Last commit	Licence	Downloads for
mrpulor-gh / nuphus-mcp	334	today	MIT	Mac, Linux
AmrDab / clawdcursor	408	today	MIT	Mac, Linux
littlebordercollie / mcd-together-order	101	24 days ago	Custom	No downloads

More: languages, topics and project record

Languages

Rust 79%
HTML 11%
Python 5%
TypeScript 3%

Topics

accessibility
ai-agents
desktop-automation
mcp
oculos
rest-api
rust
ui-automation

Project record

JobMCP servers
StatusListed
Commits24
Forks19
Watching3
Stars in 28 days+1
CreatedMar 3, 2026
First seen by usNov 7, 2026
CheckedNov 7, 2026