Complete Apple development guidance: Human Interface Guidelines (design) + Technical Documentation for iOS, macOS, watchOS, tvOS, and visionOS
npm install apple-dev-mcp 



Complete Apple development guidance for AI assistants
Combines Human Interface Guidelines (design) with Technical Documentation (API reference) for all Apple platforms.
- ๐จ Complete Coverage: HIG design guidelines + Apple API documentation for iOS, macOS, watchOS, tvOS, visionOS
- โก Smart Caching: Fast responses via intelligent caching with graceful degradation
- ๐ Smart Search: Unified search across design and technical content
- ๐ค Enhanced Search: Advanced search combining design principles with technical implementation
- ๐ Pre-built Content: 113+ pre-processed Apple HIG sections for instant access
apple-dev-mcp.dxt from releasesbash
npm install -g apple-dev-mcp
`๐ง Configuration
Claude Desktop
Add to
claude_desktop_config.json:
`json
{
"mcpServers": {
"Apple Dev": {
"command": "node",
"args": ["/usr/local/lib/node_modules/apple-dev-mcp/dist/server.js"]
}
}
}
`
Claude Code
`bash
claude mcp add "Apple-Dev" node /usr/local/lib/node_modules/apple-dev-mcp/dist/server.js
`
Cursor / Windsurf / VS Code
Create
.cursor/mcp.json, windsurf config, or .vscode/mcp.json:
`json
{
"mcpServers": {
"Apple Dev": {
"command": "node",
"args": ["/usr/local/lib/node_modules/apple-dev-mcp/dist/server.js"]
}
}
}
`
Find your path:
npm list -g apple-dev-mcp
Windows users: Replace with C:\Users\YourUsername\AppData\Roaming\npm\node_modules\apple-dev-mcp\dist\server.js๐ Usage
$3
Design Guidelines Search
-
search_human_interface_guidelines - Search Apple HIG with platform filters
- Returns full content (not snippets) for AI-friendly responses
- Covers all Apple platforms: iOS, macOS, watchOS, tvOS, visionOSTechnical Documentation Search
-
search_technical_documentation - Search Apple API documentation
- Framework-specific searches (SwiftUI, UIKit, AppKit, etc.)
- Symbol and method lookups with code examplesUnified Search
-
search_unified - Combined design + technical documentation search
- Cross-references design guidelines with implementation details
- Perfect for end-to-end development guidance$3
Search Design Guidelines:
`json
{
"name": "search_human_interface_guidelines",
"arguments": {
"query": "Tab Bars",
"platform": "iOS"
}
}
`Search Technical Documentation:
`json
{
"name": "search_technical_documentation",
"arguments": {
"query": "Button",
"framework": "SwiftUI"
}
}
`Unified Search:
`json
{
"name": "search_unified",
"arguments": {
"query": "navigation",
"platform": "iOS"
}
}
`๐งช Testing
`bash
npm test # Run test suite
npm test # Test functionalityInteractive testing
npx @modelcontextprotocol/inspector apple-dev-mcp
``We welcome contributions! The most needed help:
1. Scraper fixes when Apple changes their website
2. New features and bug fixes
3. Documentation improvements
See CONTRIBUTING.md for guidelines.
This project operates under fair use principles for educational purposes. All content includes proper Apple attribution and respects their intellectual property.
> Content sourced from Apple's Human Interface Guidelines.
> ยฉ Apple Inc. All rights reserved. Provided for educational purposes.
- MightyDillah for inspiration
- Apple Inc. for comprehensive design guidelines
- Model Context Protocol team
- Open source community for contributions
---
Built with โค๏ธ for the developer community
Bringing Apple's design excellence directly to your AI-assisted development workflow.