Server data from the Official MCP Registry
MCP server that drives the user's real macOS Chrome via AppleScript. 32 tools.
About
MCP server that drives the user's real macOS Chrome via AppleScript. 32 tools.
Security Report
Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: 3 highly-trusted packages.
5 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-dominion525-familiar-mcp": {
"args": [
"-y",
"@dominion525/familiar-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
familiar
Control your real macOS Chrome via AppleScript — no DevTools Protocol, no Playwright.
A Claude Code skill that drives Google Chrome on macOS through AppleScript (Apple Events). It uses your everyday browser instead of a headless/automated one, so pages behind bot/WAF defenses tend to treat it as a normal user.
日本語版は README.ja.md を参照してください。
What it does
Everything is tab-scoped (windowId + tabId); it never relies on the "active tab".
list_tabs/new_tab/new_incognito_tab/close_tab— tab management (new_tab uses a normal window, new_incognito_tab an incognito one)active_tab/window_mode/is_loading— inspect active tab / window mode / tab loading statenavigate/get_tab_url— navigationreload/go_back/go_forward/stop— history & reload controlwait_for_load/wait_for_selector/wait_for_function— wait for page load / element / a JS conditionget_html— get the current DOM as HTMLget_text/get_attribute/get_value/exists/query_all— read element text / attribute / value / presence / all matchesclick/fill/clear/select_option/set_checked/press_key/submit/scroll_into_view— interact with elements and formsexecute_js/execute_js_file— run arbitrary JavaScript (use the file form for complex scripts)
Selectors accept CSS (default), text=, xpath=, and label= forms.
Prerequisites
- macOS with Google Chrome
- Enable Chrome's "Allow JavaScript from Apple Events" (View → Developer → Allow JavaScript from Apple Events)
- Approve the Automation permission prompt on first run
Install
Claude Code plugin
/plugin marketplace add dominion525/familiar
/plugin install familiar@familiar
For local development / testing:
/plugin marketplace add /path/to/familiar
/plugin install familiar@familiar
Vercel Skills (agent-skills)
npx skills add dominion525/familiar
This places the skill under ~/.agents/skills/familiar/. Any client that follows the
agent-skills spec (Claude Code, Cursor, and
others) picks it up automatically. The registry is at https://skills.sh.
MCP server
The mcp/ directory contains an MCP server implementation (TypeScript) that
exposes the same 32 actions to any MCP-compatible client (Claude Code, Claude
Desktop, Cursor, Codex CLI, and others).
Quick install (Claude Code):
claude mcp add familiar -- npx @dominion525/familiar-mcp@latest
See mcp/README.md for full per-client install and configuration.
Standalone (no install)
The script also runs standalone, without installing the skill:
osascript skills/familiar/familiar.applescript list_tabs
See skills/familiar/SKILL.md for full usage.
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.