apple-design-hig
Fetches Apple HIG docs from live DocC API and serves them via CLI, skill, and MCP.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
python>=3.12 - Needs the network
install MCP server via uv tool install from git
uv tool install git+https://github.com/mr8lu/apple-design-higdowngrade mcp to <2 to fix FastMCP import error
uv pip install --python "$HOME"/.local/share/uv/tools/apple-design-hig/bin/python "mcp<2"
Where the README and reality differ
- README: uv tool install / uvx fetches apple-design-hig-mcp and runs
What worked: latest mcp 2.3.0 breaks FastMCP import; must pin mcp<2 with uv pip install --python <tool-python> "mcp<2"
Verified in pickfit: the commands exactly as its sandbox ran them
For the record only: they name the sandbox's home, /home/sbx.
uv tool install git+https://github.com/mr8lu/apple-design-hig 2>&1uv pip install --python /home/sbx/.local/share/uv/tools/apple-design-hig/bin/python "mcp<2" 2>&1apple-design-hig --help 2>&1Check that it works
apple-design-hig --help 2>&1The output should contain “usage: apple-design-hig”.
Add it to your agent
claude mcp add apple-design-hig -- apple-design-hig-mcpJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"apple-design-hig": {
"command": "apple-design-hig-mcp",
"args": []
}
}
}Add apple-design-hig-mcp as an MCP server in your MCP client, then call its tools such as hig_list_sections or hig_search.
What it does
- Get an HIG topic as MarkdownTested
How to use it
- Connect your MCP client to the
apple-design-hig-mcpserver. - Call the
hig_get_topictool with a topic slug, for example{"slug":"<topic>"}.
- Connect your MCP client to the
- Search HIG topics by keywordTested
How to use it
- Connect your MCP client to the
apple-design-hig-mcpserver. - Call the
hig_searchtool with{"query":"<your text>"}.
- Connect your MCP client to the
- Update the offline reference filesTested
How to use it
- Connect your MCP client to the
apple-design-hig-mcpserver. - Call the
hig_synctool with no arguments ({}).
- Connect your MCP client to the
How far pickfit got
Linux x86_64
- Installs
- Connects
- 3 of 3 features work
- Needs the network
Good for
- Search across all 172+ HIG topics by keyword
- Fetch and render an HIG topic as Markdown
- Synchronize offline reference catalog with live DocC API
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Needed the network
- Checked on 1 Nov 2026
- Version 0.1.0
An MCP client handshake over stdio listed 4 tools, and a call to hig_get_topic returned a result.