Familiar Mcp

io.github.dominion525Published by GitHub account dominion525v0.1.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyWeb Search & ScrapingBrowser Automation

Overview

AI-generated overview

Drives your real macOS Chrome through AppleScript, giving an assistant 32 tools to manage tabs, navigate, read pages and fill forms.

What you can do
  • Manage tabs: list, open normal or incognito tabs, close, and inspect the active tab, window mode and loading state
  • Navigate and control history: go to a URL, read the tab URL, reload, back, forward, stop
  • Wait for page load, a selector or a JavaScript condition
  • Read the page: DOM as HTML, element text, attributes, values, presence and all matches
  • Interact with elements and forms: click, fill, clear, select options, set checkboxes, press keys, submit, scroll into view
  • Run arbitrary JavaScript inline or from a file
When to use it
Useful when an assistant should work in the user's everyday Chrome profile rather than a headless or automated browser, for example on sites that treat automated browsers differently, or for tab-scoped browsing and form tasks on a Mac.
Requirements
macOS with Google Chrome installed, and the local npm package run via npx over stdio. Chrome's "Allow JavaScript from Apple Events" option must be enabled, and the macOS Automation permission prompt approved on first run. No API keys or environment variables are declared.
Before you install
It controls the user's real browser session, including incognito tabs, so logged-in accounts and cookies are exposed to whatever the assistant does. The execute_js and execute_js_file tools run arbitrary JavaScript in page context, and click, fill, submit and set_checked change pages and can submit data. Granting Automation and Apple Events JavaScript access widens what the process can do in Chrome.

Installation

In SourceWeft

  1. Open Familiar Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

bash
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

Source: README.md at commit d4b1b3c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts