Documentation

PilotGentic docs

Everything you need to install, configure, and use PilotGentic with Claude Desktop.

PilotGentic App Install

PilotGentic is an MCP (Model Context Protocol) server for macOS. Once installed, it registers itself with Claude Desktop and exposes 46+ tools that give Claude native control over your Mac.

Prerequisites

  • •macOS 14 Sonoma or later (Apple Silicon or Intel)
  • •Claude Desktop installed (download free)
  • •Accessibility permissions granted to PilotGentic (prompted on first launch)

Quick install

  1. 1. Download PilotGentic.dmg
  2. 2. Drag PilotGentic to /Applications
  3. 3. Launch PilotGentic — it auto-registers with Claude Desktop
  4. 4. Open Claude Desktop and start automating

Chrome Extension Install

The PilotGentic Chrome Extension is optional and streams live tab data — URLs, JS errors, network failures, and performance metrics — directly to the PilotGentic desktop app on your machine. Nothing leaves your computer.

Installation steps

  1. 1. Install the PilotGentic extension from the Chrome Web Store.
  2. 2. Open the PilotGentic desktop app → Browser Extension tab → click Run Native Host Installer.
  3. 3. In Chrome, go to chrome://extensions, disable then re-enable the PilotGentic extension.
  4. 4. The toolbar icon will show as active when connected to the desktop app.

What it monitors

  • •Tab titles and URLs across all open tabs
  • •JavaScript errors and unhandled promise rejections
  • •Network request failures
  • •CSP violations
  • •Performance metrics: FCP, DOM load time, memory usage, FPS

Privacy

All extension data is sent only to the PilotGentic desktop app via Chrome native messaging on localhost. Nothing is transmitted to remote servers. See our privacy policy.

MCP Tools Reference

PilotGentic exposes the following tools to Claude. Free tier includes all core tools. Pro/Max tiers unlock additional automation skills.

⌘

App Control

pilotgentic_launch_app

Launch an application by name or bundle ID

pilotgentic_quit_app

Quit a running application

pilotgentic_list_apps

List all running applications

pilotgentic_focus_app

Bring an application to the foreground

⊞

Window Management

pilotgentic_list_windows

List all open windows

pilotgentic_move_window

Move a window to specific coordinates

pilotgentic_resize_window

Resize a window to given dimensions

pilotgentic_close_window

Close a specific window

⌨

Keyboard & Mouse

pilotgentic_type_text

Type text into the focused element

pilotgentic_key_press

Send a keyboard shortcut or key combination

pilotgentic_mouse_click

Click at screen coordinates

pilotgentic_mouse_move

Move the cursor to coordinates

⊙

Screen & UI

pilotgentic_screenshot

Capture a screenshot of the screen or a window

pilotgentic_ocr_screen

Extract text from the screen via OCR

pilotgentic_find_element

Find a UI element by label or role

pilotgentic_click_element

Click a UI element by accessibility path

📁

File System

pilotgentic_read_file

Read the contents of a file

pilotgentic_write_file

Write or overwrite a file

pilotgentic_list_directory

List files in a directory

pilotgentic_move_file

Move or rename a file

⬡

Scripting

pilotgentic_run_applescript

Execute an AppleScript snippet

pilotgentic_run_shell

Run a shell command and return output

pilotgentic_open_url

Open a URL in the default browser

License Keys

PilotGentic uses a UUID-based license key system. Your key is stored locally at ~/.pilotgentic/license.json and validated against the license server on startup.

Getting a license key

Visit the pricing page and enter your email to generate a free license key. No credit card required for the Free tier.

Configuration

PilotGentic writes its MCP server config to Claude Desktop automatically on first launch. The config file is located at:

~/Library/Application Support/Claude/claude_desktop_config.json

Troubleshooting

Tools not appearing in Claude Desktop

Quit and relaunch PilotGentic, then restart Claude Desktop. PilotGentic must be running for tools to appear.

Accessibility permission errors

Go to System Settings → Privacy & Security → Accessibility and ensure PilotGentic is enabled.

License validation fails

Check your internet connection. If the issue persists, re-enter your license key in PilotGentic settings.

Chrome says the native host is not found

Open PilotGentic → Browser Extension tab → click "Run Native Host Installer". Then go to chrome://extensions and disable/re-enable the extension to reload the native host manifest.