Featured

Launch OpenClaw on Hostinger in about 60 seconds and keep your agent live 24/7. Our referral link gives you 20% off, no coupon code needed.

Launch on Hostinger →

Run your Hermes agent on Hostinger, fully managed

Launch Hermes on Hostinger in one click, fully managed, no VPS knowledge needed. Use code ZACAARON10 for 10% off.

Launch on Hostinger →

Crawl and scrape any site into clean data, 10% off

Firecrawl crawls and scrapes any site into clean markdown for your agent. Get 1,000 free credits, and new users get 10% off their first purchase.

Try Firecrawl free →

6,000+ web scrapers for your AI agent, start free

Apify gives your agent live web data: 6,000+ prebuilt scrapers and actors, MCP-ready. Sign up free with $5 in usage credits.

Try Apify free →

One API to scrape, enrich, and extract the internet.

Context.dev gives your agents a single API to scrape, enrich, and extract live web data — no proxies, no parsers, no maintenance.

Start building free →

SetupClaw: done-for-you OpenClaw for founders & exec teams

White-glove OpenClaw for founders and exec teams (4–50+ employees): we install, harden, integrate your tools, and maintain it — secured from day one.

Get it set up for you →

SEO data APIs for your agent, $1 free credit

DataForSEO gives your agent live access to SERP results, keyword data, backlinks, and on-page SEO data through one API. New accounts get a $1 credit, good for up to 20,000 keyword or backlink lookups.

Try DataForSEO free →

Reach 48,000+ AI builders

A flat monthly placement in front of developers actively installing AI tools. No lock-in, cancel anytime.

Advertise here →

Deploy OpenClaw in 60 seconds — 20% off

Launch on Hostinger →

Run your Hermes agent on Hostinger, fully managed

Launch on Hostinger →

Crawl and scrape any site into clean data, 10% off

Try Firecrawl free →

6,000+ web scrapers for your AI agent, start free

Try Apify free →

One API to scrape, enrich, and extract the internet.

Start building free →

SetupClaw: done-for-you OpenClaw for founders & exec teams

Get it set up for you →

SEO data APIs for your agent, $1 free credit

Try DataForSEO free →

Reach 48,000+ AI builders

Advertise here →

familiar-mcp

dominion525/familiar

0 starsv0.1.1STDIORegistry activeMITUpdated 2026-06-25Community

Deploy on Hostinger →up to 70% off + an extra 10% with code ZACAARON10 Free API →

Works with

Claude CodeClaude DesktopCursorVS CodeClineCodex CLIOpenClaw+ any MCP client

Install to Claude Code

claude mcp add familiar -- npx -y @dominion525/familiar-mcp

Summary

MCP server that drives the user's real signed-in Chrome on macOS via AppleScript (Apple Events). 32 tools covering tab/window control, navigation, DOM extraction, form interaction, and arbitrary JS execution.

Connect from your MCP client

One-click install

Add this server to your editor with a single click. Fill in any required credentials afterward.

Install in Cursor Install in VS Code

Claude Code

Run this once and Claude Code registers the server for you:

claude mcp add familiar -- npx -y @dominion525/familiar-mcp

Claude Desktop

Add this to claude_desktop_config.json under Settings → Developer → Edit Config:

{
  "mcpServers": {
    "familiar": {
      "command": "npx",
      "args": [
        "-y",
        "@dominion525/familiar-mcp"
      ]
    }
  }
}

Cursor

Add this to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for all projects):

{
  "mcpServers": {
    "familiar": {
      "command": "npx",
      "args": [
        "-y",
        "@dominion525/familiar-mcp"
      ]
    }
  }
}

Cline and other MCP clients

Most MCP clients accept the standard mcpServers JSON block:

{
  "mcpServers": {
    "familiar": {
      "command": "npx",
      "args": [
        "-y",
        "@dominion525/familiar-mcp"
      ]
    }
  }
}

Codex CLI

codex mcp add familiar -- npx -y @dominion525/familiar-mcp

# or add to ~/.codex/config.toml:
[mcp_servers.familiar]
command = "npx"
args = ["-y", "@dominion525/familiar-mcp"]

OpenClaw

OpenClaw reads MCP servers from the mcp.servers section of ~/.openclaw/openclaw.json (managed via `openclaw mcp add` or the mcporter skill):

{
  "mcp": {
    "servers": {
      "familiar": {
        "command": "npx",
        "args": [
          "-y",
          "@dominion525/familiar-mcp"
        ]
      }
    }
  }
}

README.md

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

/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

See related servers & alternatives →

Score

0–100

63/ 100

Grade

Popularity2/25

No GitHub stars yet.

Maintenance20/20

Updated within the last 90 days.

Completeness20/20

Complete metadata: install, license, description, config, and tags.

Trust9/15

Listed and active in the MCP registry.

Security12/20

Tool surface not yet analyzed.

Scored automatically from popularity, maintenance, completeness, trust, and security. How we score →

Proud of your score? Add this badge to your README.

Paste a snippet into your GitHub README. The badge updates automatically and links back to this page.

Score badge

Markdown

[![familiar-mcp MCP server](https://www.claudemarket.ai/mcp/dominion525/familiar/badges/score.svg)](https://www.claudemarket.ai/mcp/dominion525/familiar)

HTML

<a href="https://www.claudemarket.ai/mcp/dominion525/familiar"><img src="https://www.claudemarket.ai/mcp/dominion525/familiar/badges/score.svg" alt="familiar-mcp MCP server"/></a>

Card badge

Markdown

[![familiar-mcp MCP server](https://www.claudemarket.ai/mcp/dominion525/familiar/badges/card.svg)](https://www.claudemarket.ai/mcp/dominion525/familiar)

HTML

<a href="https://www.claudemarket.ai/mcp/dominion525/familiar"><img src="https://www.claudemarket.ai/mcp/dominion525/familiar/badges/card.svg" alt="familiar-mcp MCP server"/></a>