This MCP server gives LLMs live access to Apple's Human Interface Guidelines for searching, retrieving, and applying design guidance.
Search 160+ HIG topics by keyword, with optional category filtering.
Fetch complete live Markdown documentation for any HIG topic from developer.apple.com.
List top-level HIG categories with topic counts.
List topics within a category or all indexed topics, with titles, slugs, and summaries.
Generate actionable redesign and polish checklists for iOS, macOS, visionOS, or all platforms.
Get official Apple design resource links, including Figma kits, SF Symbols, app icon templates, and device bezels.
Provides LLMs with direct access to Apple's Human Interface Guidelines by fetching live Markdown documents from developer.apple.com. Enables searching 160+ HIG topics, retrieving full guideline documentation, listing categories and topics, generating redesign/polish checklists, and surfacing official design resources such as SF Symbols and Figma kits.
Delivers iOS-specific HIG guidance, including topics on components, patterns, inputs, and design heuristics such as 44pt touch targets, continuous curvature (squircle), button hierarchies, and spring physics, plus an iOS redesign checklist.
Delivers macOS-specific HIG guidance covering foundations, components, patterns, and inputs, along with a macOS redesign and polish checklist.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Apple HIG MCP Server search the HIG for Liquid Glass materials and button hierarchy"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Model Context Protocol (MCP) server providing LLMs direct access to Apple's Human Interface Guidelines (HIG) via live developer.apple.com Markdown endpoints.
Live Endpoints: Fetches .md documents directly from Apple Developer CDN on demand.
Local Cache: In-memory and disk cache (~/.cache/apple-hig-mcp) with 24-hour TTL.
Coverage: 160+ topics spanning Foundations, Components, Patterns, Inputs, Technologies, and Platforms (iOS, macOS, visionOS, watchOS, tvOS).
Design Guidance: Built-in heuristics for Liquid Glass layering, 44pt touch targets, continuous curvature (squircle), button hierarchies, and spring physics.
6 Tools: Search, full topic retrieval, category listings, redesign checklists, and official asset links (Figma, SF Symbols).
Related MCP server: apple-design-mcp
Tool | Description |
| Search 160+ topics, titles, descriptions, and synonyms ( |
| Retrieve live Markdown documentation for any topic ( |
| List main HIG categories and topic counts. |
| List topics within a category with summaries. |
| Generate actionable HIG redesign & polish checklist (iOS, macOS, visionOS). |
| Official links for Apple Figma kits, SF Symbols, and design templates. |
Add directly to your MCP client configuration (claude_desktop_config.json, Antigravity mcp_config.json, or Cursor):
{
"mcpServers": {
"apple-hig": {
"command": "npx",
"args": ["-y", "@dark0nly/apple-hig-mcp"]
}
}
}Or install via Claude Code CLI in one command:
claude mcp add apple-hig -- npx -y @dark0nly/apple-hig-mcpOr install via Smithery CLI:
npx -y @smithery/cli install @dark0nly/apple-hig-mcp --client claudenpm install -g @dark0nly/apple-hig-mcpThen reference the binary directly:
{
"mcpServers": {
"apple-hig": {
"command": "apple-hig-mcp"
}
}
}git clone https://github.com/Amo643/apple-hig-mcp.git
cd apple-hig-mcp
npm install
npm run buildnode test.js
node test-mcp-stdio.jsMIT
Get direct download and official links to Apple Design Resources (Figma kits, SF Symbols, app icon templates, device bezels).
Inputs: no named parameters.
Fetch the complete, live Markdown content of any Apple HIG topic directly from developer.apple.com.
Inputs: topic (required).
Generate an actionable Apple HIG checklist for redesigning and polishing apps to feel native and refined.
Inputs: platform.
List all top-level categories in Apple Human Interface Guidelines with topic counts.
Inputs: no named parameters.
List all topics within a specific category with their titles, slugs, and summaries.
Inputs: category.
Search across Apple Human Interface Guidelines topics, titles, descriptions, and categories in real-time.
Inputs: query (required), category.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 6 tools
Each tool has a largely distinct role: search finds topics, get_guideline fetches full content, list_categories and list_topics navigate the hierarchy, and the checklist/resource tools are clearly separate utilities. The only mild overlap is between search_hig and get_guideline, since both retrieve guideline content, but their descriptions distinguish discovery from full retrieval.
All tool names use consistent snake_case with a predictable verb_noun pattern: search_hig, get_guideline, list_categories, list_topics, get_redesign_checklist, get_design_resources. The naming is readable and uniform across the set.
Six tools is well-scoped for a read-only Apple HIG reference server. Each tool covers a meaningful browsing, retrieval, or resource-access function without redundant entries.
The surface covers discovery, full-content retrieval, category/topic navigation, redesign checklists, and design resources, which is strong for a HIG reference server. Minor gaps remain, such as a global topic listing or richer cross-referencing between related guidelines, but core workflows are covered.
Patterns for designing and reviewing AI skills, agents, and multi-agent workflows. Find guidance on context economy, delegation, verification, and tool design; inspect claims, worked examples, maturity labels, and source references. Five read-only tools let agents discover relevant patterns, compare concise cards, read specific sections, and explore relationships. Hosted Streamable HTTP at https://agentic-atlas.dev/mcp/ — no installation, account, or API key required. Browse the atlas at https://agentic-atlas.dev/.
Live AI-native web search with citations. One tool for every MCP client. Flat per-request pricing.
Search and inspect source-pinned agent skills, plugins and tools through a free public MCP.
MCP connector that lets ChatGPT list, search, and run your Apple Shortcuts via a local Mac agent
