Familiar MCP

MCP server that drives the user's real macOS Chrome via AppleScript. 32 tools.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "familiar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "skills"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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 state
navigate / get_tab_url — navigation
reload / go_back / go_forward / stop — history & reload control
wait_for_load / wait_for_selector / wait_for_function — wait for page load / element / a JS condition
get_html — get the current DOM as HTML
get_text / get_attribute / get_value / exists / query_all — read element text / attribute / value / presence / all matches
click / fill / clear / select_option / set_checked / press_key / submit / scroll_into_view — interact with elements and forms
execute_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

Code

/plugin marketplace add dominion525/familiar
/plugin install familiar@familiar

For local development / testing:

Code

/plugin marketplace add /path/to/familiar
/plugin install familiar@familiar

Vercel Skills (agent-skills)

Terminal

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):

Terminal

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:

Code

osascript skills/familiar/familiar.applescript list_tabs

See skills/familiar/SKILL.md for full usage.

License

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Familiar MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "familiar-mcp": { "command": "npx", "args": ["-y", "familiar-mcp"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/familiar-mcp?style=directory)](https://allmcps.com/mcp/familiar-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/familiar-mcp"><img src="https://allmcps.com/api/badge/familiar-mcp?style=directory" alt="Familiar MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

35Quality signal: Fair · 35/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools15/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Familiar MCP →Install in Claude Desktop Install in Cursor Install in VS Code

Familiar MCP

MCP server that drives the user's real macOS Chrome via AppleScript. 32 tools.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "familiar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "skills"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

familiar

Control your real macOS Chrome via AppleScript — no DevTools Protocol, no Playwright.

日本語版は 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 state
navigate / get_tab_url — navigation
reload / go_back / go_forward / stop — history & reload control
wait_for_load / wait_for_selector / wait_for_function — wait for page load / element / a JS condition
get_html — get the current DOM as HTML
get_text / get_attribute / get_value / exists / query_all — read element text / attribute / value / presence / all matches
click / fill / clear / select_option / set_checked / press_key / submit / scroll_into_view — interact with elements and forms
execute_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

Code

/plugin marketplace add dominion525/familiar
/plugin install familiar@familiar

For local development / testing:

Code

/plugin marketplace add /path/to/familiar
/plugin install familiar@familiar

Vercel Skills (agent-skills)

Terminal

npx skills add dominion525/familiar

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):

Terminal

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:

Code

osascript skills/familiar/familiar.applescript list_tabs

See skills/familiar/SKILL.md for full usage.

License

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Familiar MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "familiar-mcp": { "command": "npx", "args": ["-y", "familiar-mcp"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/familiar-mcp?style=directory)](https://allmcps.com/mcp/familiar-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/familiar-mcp"><img src="https://allmcps.com/api/badge/familiar-mcp?style=directory" alt="Familiar MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

35Quality signal: Fair · 35/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools15/30

Adoption & activity1/15

Community engagement0/10

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Familiar MCP →Install in Claude Desktop Install in Cursor Install in VS Code