computer-access
Browser-family adapter that captures user-authorized Arc window text and layout geometry for local history search, read, and layout queries through the MCP tools.
Browser-family adapter that captures user-authorized Brave window text and layout geometry for local history search, read, and layout queries through the MCP tools.
Browser-family adapter that captures user-authorized Firefox window text and layout geometry for local history search, read, and layout queries through the MCP tools.
Browser-family adapter that captures user-authorized Helium window text and layout geometry for local history search, read, and layout queries through the MCP tools.
Terminal-family adapter that captures user-authorized iTerm2 terminal text and window layout for local history search, read, and layout queries through the MCP tools.
Browser-family adapter that captures user-authorized Opera window text and layout geometry for local history search, read, and layout queries through the MCP tools.
Built-in Slack adapter that captures user-authorized Slack surface text and window layout for local history search, read, and layout queries through the MCP tools.
Browser-family adapter that captures user-authorized Vivaldi window text and layout geometry for local history search, read, and layout queries through the MCP tools.
Terminal-family adapter that captures user-authorized Warp terminal text and window layout for local history search, read, and layout queries through the MCP tools.
Custom WeChat 4.x adapter using Qt extractSurface and AXParent ownership proof to capture user-authorized WeChat surface text and layout for local history queries through the MCP tools.
Terminal-family adapter that captures user-authorized WezTerm terminal text and window layout for local history search, read, and layout queries through the MCP tools.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
computer-access-mcp
Host-agnostic local desktop history daemon, Web Control Panel, and scoped Model Context Protocol (MCP) server.
computer-access-mcp captures user-authorized desktop text, selections, input text, and window layout geometry into a local AES-256-GCM segment store. Humans manage permissions, capture scope, retention, and token leases through a local Web UI; AI agents (Antigravity, Claude Code, Cursor, etc.) query retained context through a least-privilege MCP interface.
Architecture
+---------------------------+ Admin Bearer Token +-------------------------------+
| Browser Control Panel | <------------------------------> | computer-access-mcp serve |
| http://127.0.0.1:43180/ | REST /api/* + Static | (Node HTTP Daemon, 127.0.0.1)|
+---------------------------+ +---------------+---------------+
|
+---------------------------+ Scoped Client Lease Token |
| AI Agents (Antigravity, | POST /mcp (Streamable HTTP) |
| Claude Code, Cursor) | <------------------------------------------------+
| or `stdio` proxy CLI | Tools: status/search/read/layout/pause |
+---------------------------+ |
+---------------------------+---------------------------+
| |
v v
+------------------------------+ +------------------------------+
| SegmentStore (AEAD Log) | | Native Collector Supervisor |
| - store.lock (flock/Win32) | | - macOS AX Collector/Worker |
| - store.meta + seg-*.cah | | - AppAdapter Meta-Framework |
| - Keychain / DPAPI 32B Key | | - Pre-read Privacy Gates |
+------------------------------+ +------------------------------+Related MCP server: computer-copilot
Quickstart
Requirements: Node.js >= 24.12.0, pnpm, and Xcode Command Line Tools (swift / clang on macOS).
pnpm install
pnpm build:storage-lock
pnpm build:native
pnpm build
pnpm serveWhen computer-access-mcp serve starts, it listens on 127.0.0.1:43180 and prints a local login URL:
Web UI: http://127.0.0.1:43180/#token=<admin-token>
MCP HTTP: http://127.0.0.1:43180/mcpOpen the printed
Web UIlink in your browser (the#token=...fragment is stored insessionStorageand immediately cleared from the URL bar).Click Initialize Encryption Key on the Overview & Permissions tab, grant macOS Accessibility (and optional Input Monitoring), and click Start Capture.
Open MCP Access (Client Tokens) to generate a scoped token (
camcp_...) for your AI client.
Connecting Antigravity / Claude / Cursor via MCP
After creating a Client Token in the Web Control Panel, click Copy HTTP MCP Config JSON or Copy stdio MCP Config JSON.
Option A: Streamable HTTP (Direct)
{
"mcpServers": {
"computer-access": {
"url": "http://127.0.0.1:43180/mcp",
"headers": {
"Authorization": "Bearer camcp_<your_client_token>"
}
}
}
}Option B: stdio Proxy (Recommended for Local Source Checkout)
Use the full node and dist/server/cli.js paths (the Web Control Panel's Copy stdio MCP Config JSON button fills both paths automatically for your machine):
{
"mcpServers": {
"computer-access": {
"command": "/full/path/to/node",
"args": ["/full/path/to/repo/dist/server/cli.js", "stdio"],
"env": {
"COMPUTER_ACCESS_TOKEN": "camcp_<your_client_token>",
"COMPUTER_ACCESS_URL": "http://127.0.0.1:43180/mcp"
}
}
}
}Exposed MCP Tools
Tool | Required Scope | Purpose |
|
| Service state, active capture scope, and retained time range |
|
| Search retained observations by keyword, bundle ID, kind, and time window |
|
| Read the full observation record by |
|
| Read window-relative node bounds and text from a surface snapshot |
|
| Pause active capture immediately (cannot start or resume capture) |
|
| Hot-reload the native Collector ( |
Built-In Application Adapters
The macOS Collector pairs a thin AX security kernel with eight built-in adapters (generic fallback, six declarative adapters, and the custom wechat adapter): vscode-family (Antigravity, VSCode, Cursor, Windsurf), browser-family (Chrome, Chromium, Brave, Edge, Arc, Dia, Vivaldi, Opera, Firefox, Zen, Floorp, Comet, Atlas, Helium), terminal-family (Terminal, iTerm2, Ghostty, Warp, Kitty, WezTerm, Rio, Wave), qq, feishu, wechat (WeChat 4.x Qt custom extractSurface + AXParent ownership proof), and slack (Slack). Surface reads batch AXPosition/AXSize/AXIdentifier in metadata queries, fetch AXStaticText bounded ranges in a single shot (with safeTitle/AXValue fallback on verified non-sensitive leaves), and trigger a serial Return fast focused read followed by a 200 ms full surface refresh. See docs/adapters.md.
Security Model Summary
Pre-Read Blocking: Password managers (1Password, Apple Passwords, Keychain Access, Bitwarden, Dashlane, LastPass, NordPass, Proton Pass),
com.apple.safari*, private/incognito browser windows, System UI overlays, locked screens, active Secure Input, and password/protected UI fields are blocked before text extraction.Encrypted at Rest: Observations are encrypted frame-by-frame using AES-256-GCM in 4 MiB append-only segments (
seg-*.cah), keyed by a 32-byte master key in macOS Keychain (or Windows DPAPI).Two-Tier Credentials: Full control requires the local
admin.token(protected byHost/Originvalidation against DNS rebinding and cross-site requests). Agent tokens store only SHA-256 digests on disk, carry explicit expiration/revocation, and never receive lifecycle start, policy edit, or Forget permissions.
Documentation
See docs/README.md for the full design documentation index.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Memory for your AI: what you saw on screen, said in calls and worked on, searchable by agents.
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Real desktops for AI agents, on machines you choose: screenshot, type, click, hire more agents.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to read what is on a Windows desktop as text — open windows, their contents, and what changed — using Win32 and UI Automation with optional NPU vision. Secrets, password fields, and private windows are withheld and personal data scrubbed on the user's PC before anything reaches the agent.AGPL 3.0
- AlicenseNot gradedqualityBmaintenanceEnables AI clients to operate Windows desktops through native UIA control, OCR text targeting, screenshots, and 54 tools for window, process, input, clipboard, file, registry, and document tasks with pause, observe-only, and privacy safeguards.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to inspect and operate Windows desktop applications and Chrome tabs in the background while the user retains mouse, keyboard, and window control. It provides consent prompts, hard deny lists, visible activity indicators, and an emergency stop for safer computer use.1Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables local AI clients to observe and control a Windows desktop by listing and focusing windows, capturing screenshots, and—when input is explicitly enabled—performing clicks, typing Unicode text, and pressing keys or shortcuts. Input tools are gated off by default, and no shell execution or remote listener is exposed.MIT