Schema | macos-ui-mcp

macos-ui-mcp

Describes the environment variables required to run the server.

Name	Required	Description	Default
`MACOS_UI_MCP_HARNESS_URL`	No	The URL of the AppMCPHarness HTTP server running in the macOS app.	http://127.0.0.1:8787

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Features and capabilities supported by this server

Protocol revision2025-11-25

Capability	Details
`tools`	{ "listChanged": true }

Functions exposed to the LLM to take actions

Name	Description
list_windowsA	List the app's on-screen windows (id, title, key, frame).
get_ui_treeA	Dump the semantic view tree of a window as JSON: roles, labels, values, enabled/focused state, frames, and stable ids. Use `compact` for a terse outline.
screenshotA	Render a window (or a single node via `selector`) to PNG. Rendered in-process by the app — no Screen Recording permission.
clickB	Tap a view matched by selector. Selector grammar: "#id" \| Role "Label" \| "Label" \| Role.
typeC	Set the text value of a field matched by selector.
invoke_actionC	Trigger a named action hook registered by the app via AppMCP.registerAction(name, …).
wait_forB	Poll the UI tree until a selector appears, or time out.

Interactive templates invoked by user choice

Name	Description
No prompts

Contextual data attached and managed by the client

Name	Description
No resources

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/thangduonghuu/macos-ui-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server