Skip to main content

Installation

Glyphs MCP ships as a Glyphs 3 plug-in plus a small Python dependency set. Install it first, then start the local MCP server from inside Glyphs.

Use the installer. It can install the plug-in, install dependencies where Glyphs can load them, link supported clients, and optionally install bundled agent skills.

Supported automatic links:

  • Codex App
  • Codex CLI
  • Claude App
  • Claude CLI

Run from the repo root:

python3 install.py

On macOS, you can also double-click RunInstall.command in Finder. If Gatekeeper blocks it, right-click it and choose Open once.

Glyphs MCP Installer

Requirements​

  • macOS with Glyphs 3
  • Python 3.11-3.13
  • Local access to the repo checkout or a downloaded release package

If python3 is missing or too old, install Python 3.12 from python.org and rerun the installer.

What the installer does​

  • Detects a supported Python environment.
  • Installs Python dependencies for Glyphs.
  • Installs or links Glyphs MCP.glyphsPlugin into Glyphs' plug-ins folder.
  • Can link supported local MCP clients.
  • Can copy bundled glyphs-mcp-* skills into Codex or Claude Code skill directories.
  • Verifies imports and prints actionable errors when setup fails.

Downloads​

Scripted install​

For automation or reproducible development setup, use non-interactive mode:

python3 install.py --non-interactive --python-mode glyphs --plugin-mode link --skip-skills --skip-client-guidance

Add skill installation when needed:

python3 install.py --non-interactive --python-mode glyphs --plugin-mode link --install-skills --skills-target codex --overwrite-plugin --overwrite-skills --skip-client-guidance

Verify installation​

After installation, restart Glyphs. The Edit menu should include:

  • Start Glyphs MCP Server
  • Glyphs MCP Server Status...

Then continue to Start the server.

Uninstall​

  1. Quit Glyphs.

  2. Remove Glyphs MCP.glyphsPlugin from:

    ~/Library/Application Support/Glyphs 3/Plugins/

Optional advanced cleanup: remove Glyphs MCP packages from:

~/Library/Application Support/Glyphs 3/Scripts/site-packages

Be careful in Scripts/site-packages; other Glyphs scripts may depend on packages stored there.