Skip to main content

Connect a client

All clients connect to the same local endpoint:

http://127.0.0.1:9680/mcp/

Start Glyphs MCP before connecting the client. If connection fails, restart Glyphs, start the server, then reload the client.

The installer can link Glyphs MCP into:

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

Any MCP-compatible client can use the server if it supports a local Streamable HTTP endpoint or a bridge to one.

Codex App and Codex CLI​

Use the Codex MCP command:

codex mcp add glyphs-mcp-server --url http://127.0.0.1:9680/mcp/
codex mcp list

Codex can also read the server from ~/.codex/config.toml:

[mcp_servers.glyphs-mcp-server]
url = "http://127.0.0.1:9680/mcp/"
enabled = true
startup_timeout_sec = 30
tool_timeout_sec = 120

Reload Codex after changing MCP configuration.

Claude CLI and Claude Code​

Use the Claude CLI:

claude mcp add --scope user --transport http glyphs-mcp http://127.0.0.1:9680/mcp/
claude mcp list

In Claude Code, run /mcp after reload to confirm the server is listed.

Claude App​

Claude App configuration uses ~/Library/Application Support/Claude/claude_desktop_config.json. In this config format, Claude App usually needs a local bridge command for a localhost HTTP MCP endpoint.

One option is npx mcp-remote:

{
"mcpServers": {
  "glyphs-mcp-server": {
    "command": "npx",
    "args": [
      "mcp-remote",
      "http://127.0.0.1:9680/mcp/"
    ]
  }
}
}

If you edit the file manually, preserve unrelated top-level settings and other MCP servers.

Python bridge alternative​

Some users prefer a Python bridge such as mcp-proxy:

pip install mcp-proxy
{
"mcpServers": {
  "glyphs-mcp-server": {
    "command": "mcp-proxy",
    "args": [
      "http://127.0.0.1:9680/mcp/",
      "--transport=streamablehttp"
    ],
    "env": {
      "PATH": "/Users/thierryc/.local/bin:/Users/thierryc/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
    }
  }
}
}

Set env.PATH when the app cannot find commands that work in Terminal. Common command locations include ~/.local/bin, /opt/homebrew/bin, and /usr/local/bin.

Verify​

After connecting, paste this prompt into the client:

Call list_open_fonts and tell me how many fonts are open.
If you see an error, quote it verbatim.

If it still fails​

  • Confirm Glyphs is open.
  • Confirm Edit -> Glyphs MCP Server Status... shows a running server.
  • Confirm the endpoint is exactly http://127.0.0.1:9680/mcp/.
  • Reload the client so it fetches the current tools/list.
  • Continue to Troubleshooting.