Skip to content
Back to search

apple-design-mcp

MarketplaceWorks with Claude CodeGitHub

A free remote MCP server that gives AI assistants Apple's design material.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/traviskirton--apple-design-mcp/badge.svg)](/listings/traviskirton--apple-design-mcp)

HTML

<a href="/listings/traviskirton--apple-design-mcp"><img src="/api/listings/traviskirton--apple-design-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 11 lines
  1. {
  2. "name": "apple-design-mcp",
  3. "owner": { "name": "Travis Kirton" },
  4. "plugins": [
  5. {
  6. "name": "apple-design",
  7. "source": "./plugin",
  8. "description": "Apple's design resources for designing Apple apps: the Apple Design MCP server plus a skill that tells the agent how to use it."
  9. }
  10. ]
  11. }
README.md · README · 97 lines
  1. # Apple Design MCP
  2. A free remote MCP server that gives AI assistants Apple's design material: the Human Interface Guidelines, every SF Symbol, Apple's iOS and macOS UI kit components, device screen sizes and frames, and Apple's technology artwork. With it, an assistant places Apple's own symbols, components and frames instead of guessing them.
  3. ```
  4. https://apple-design-mcp.com/mcp
  5. ```
  6. No install, no sign-in, no API key. Site: [apple-design-mcp.com](https://apple-design-mcp.com).
  7. ## Set it up
  8. | Client | How |
  9. | --- | --- |
  10. | **Claude** (chat, projects, desktop and mobile apps) | Settings → Connectors → **Add custom connector**. Name it "Apple Design" and paste the URL. |
  11. | **Claude Code** | `claude mcp add --transport http apple-design https://apple-design-mcp.com/mcp` |
  12. | **Cursor** | In `~/.cursor/mcp.json`: `{ "mcpServers": { "apple-design": { "url": "https://apple-design-mcp.com/mcp" } } }` |
  13. | **VS Code** | In `.vscode/mcp.json`: `{ "servers": { "apple-design": { "type": "http", "url": "https://apple-design-mcp.com/mcp" } } }` |
  14. | **ChatGPT** (Plus, Pro, Business, Enterprise, on the web) | [chatgpt.com/plugins](https://chatgpt.com/plugins) → **+** → **Add custom MCP server**. Paste the URL under Server URL, choose No authentication, then create and install the plugin. If **+** doesn't offer it, turn on Developer mode at [chatgpt.com/settings/security](https://chatgpt.com/settings/security). |
  15. | **Perplexity** (Pro, Max, Enterprise) | Plugins → **Add custom → Connector → Add MCP connector** → Remote. Paste the URL, Authentication None, Transport Streamable HTTP. |
  16. | **Grok** | [grok.com/connectors](https://grok.com/connectors) → **New Connector** → Custom. Paste the URL under Server URL. |
  17. | **Anything else** | Add the URL as a remote MCP server. No authentication. |
  18. Then try: *Design the recipe detail screen of a cooking app for iPhone Duo, closed and open.*
  19. ### Agent skill and Claude Code plugin
  20. `plugin/skills/apple-design/SKILL.md` tells an agent when to use the server and how: one `get_design_brief` call per device, Apple's SVGs placed as they are in mockups, and the system's own components in SwiftUI, UIKit and AppKit code.
  21. - **Claude Code:** `/plugin marketplace add traviskirton/apple-design-mcp`, then `/plugin install apple-design@apple-design-mcp`. This installs the skill and connects the server.
  22. - **claude.ai and the Claude apps:** download [apple-design-skill.zip](https://apple-design-mcp.com/apple-design-skill.zip) and upload it under Settings → Capabilities → Skills. Add the server separately as a custom connector.
  23. ## What's inside
  24. - **9,184 SF Symbols**, as SVG in all 9 weights.
  25. - **2,310 components** from Apple's UI kits for iOS and iPadOS 27 and macOS 27 (watchOS coming), as Apple's own drawings with their measurements.
  26. - **210 product bezels** from Apple's design resources, plus vector frames from Xcode's Simulator.
  27. - **Screen sizes and safe areas** for every current device, including both screens of iPhone Duo.
  28. - **The Human Interface Guidelines**, all pages, searchable.
  29. - **Design values:** system colors (light, dark, increased contrast), text styles, standard sizes, materials and Liquid Glass settings.
  30. - **Technology artwork:** Sign in with Apple, AirPlay, Game Center and others.
  31. ## Tools
  32. | Tool | What it does |
  33. | --- | --- |
  34. | `get_design_brief` | One call for a device's whole screen: its size, the guidelines, Apple's drawings of the components, the icons and the system values. |
  35. | `search_hig` | The guideline text for a list of components, patterns and devices, in one reply. |
  36. | `get_hig_page` | One guidelines page or section by id. |
  37. | `get_device_metrics` | Screen sizes in points and pixels, scale, corner radius, Dynamic Island, safe areas. |
  38. | `get_device_frame` | Apple's product bezels and a vector frame to show a design inside a device. |
  39. | `search_symbols` / `get_symbol` | SF Symbols as SVG, by plain words or exact name. |
  40. | `search_ui_kit` | Apple's UI kit components with their layers, sizes, colors and text styles. |
  41. | `get_design_values` | System colors, text styles, standard sizes, materials, Liquid Glass and iPhone Duo layout guides. |
  42. | `get_technology_assets` | Apple's artwork for its technologies. |
  43. | `get_pack_info` | What material is loaded and its date. |
  44. `server/README.md` describes each tool and how its data is built.
  45. ## Repository
  46. | Folder | What it holds |
  47. | --- | --- |
  48. | `server/` | The MCP server: TypeScript on Cloudflare Workers. Its `assets/` folder also serves the website at apple-design-mcp.com. |
  49. | `extractor/` | A Swift tool that reads SF Symbols on a Mac and writes the server's symbol data. |
  50. | `plugin/` | The agent skill and the Claude Code plugin. |
  51. | `scripts/` | `fetch_apple_design_resources.py`, which downloads Apple's design resources (bezels, technology artwork) for the packs. |
  52. | `quality-test/` | The test that came before the server: does Claude write better SwiftUI with this material? |
  53. ### Run it
  54. ```sh
  55. cd server
  56. npm install
  57. npm run dev # local server at http://localhost:8787/mcp
  58. npm run check # types, SVG, ranking and coverage tests
  59. npx wrangler deploy
  60. ```
  61. Run `npm run pack` before a deploy to pick up Apple's latest guidelines.
  62. ### Download Apple's design resources
  63. `scripts/fetch_apple_design_resources.py` downloads the files on [Apple's design resources page](https://developer.apple.com/design/resources/) into `apple-resources/` (ignored by git) and keeps them current. Run it on a Mac:
  64. ```sh
  65. python3 scripts/fetch_apple_design_resources.py --list # show what the page offers
  66. python3 scripts/fetch_apple_design_resources.py --only "iphone duo" # one bezel set
  67. python3 scripts/fetch_apple_design_resources.py --only bezel --extract # all bezels, unpacked
  68. python3 scripts/fetch_apple_design_resources.py # every direct download
  69. ```
  70. A second run skips files that haven't changed, so it doubles as the update check. `--extract` unpacks each new `.dmg` into `apple-resources/extracted/`, and `apple-resources/manifest.json` records sizes, dates and hashes. Sketch and Figma kits can't be downloaded by a script; it lists them at the end.
  71. ---
  72. Not affiliated with or endorsed by Apple. Apple's guidelines, symbols, UI kits and artwork belong to Apple and are subject to Apple's terms.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.