Apple Docs MCP
Provides tools to search and retrieve content from official Apple Developer Documentation, including framework references, technical guides, and WWDC session resources.
Enables access to iOS-specific API documentation, platform compatibility analysis, and framework details for developers building for iPhone and iPad.
Enables access to macOS-specific API documentation, platform compatibility analysis, and framework details for desktop application development.
Provides access to official Swift language documentation, API references, and code examples for development across Apple platforms.
Offers access to Xcode-related documentation and release notes to support development workflows on Apple platforms.
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 Docs MCP how do I use AsyncImage in SwiftUI?"
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.
Apple Docs MCP - Apple Developer Documentation Model Context Protocol Server
Apple Developer Documentation MCP Server - Access Apple's official developer docs, frameworks, APIs, SwiftUI, UIKit, and WWDC videos through Model Context Protocol. Search iOS, macOS, watchOS, tvOS, and visionOS documentation with AI-powered natural language queries. Get instant access to Swift/Objective-C code examples, API references, and technical guides directly in Claude, Cursor, or any MCP-compatible AI assistant.
✨ Features
🔍 Smart Search: Intelligent search across Apple Developer Documentation for SwiftUI, UIKit, Foundation, CoreData, ARKit, and more
📚 Complete Documentation Access: Full access to Apple's JSON API for Swift, Objective-C, and framework documentation
🔧 Framework Index: Browse hierarchical API structures for iOS, macOS, watchOS, tvOS, visionOS frameworks
📋 Technology Catalog: Explore Apple technologies including SwiftUI, UIKit, Metal, Core ML, Vision, and ARKit
📰 Documentation Updates: Track WWDC 2024/2025 announcements, iOS 26, macOS 26, and latest SDK releases
🎯 Technology Overviews: Comprehensive guides for Swift, SwiftUI, UIKit, and all Apple development platforms
💻 Sample Code Library: Swift and Objective-C code examples for iOS, macOS, and cross-platform development
🎥 WWDC Video Library: Search WWDC 2014-2025 sessions with transcripts, Swift/SwiftUI code examples, and resources
🔗 Related APIs Discovery: Find SwiftUI views, UIKit controllers, and framework-specific API relationships
📊 Platform Compatibility: iOS 13+, macOS 10.15+, watchOS 6+, tvOS 13+, visionOS compatibility analysis
⚡ High Performance: Optimized for Xcode, Swift Playgrounds, and AI-powered development environments
🔄 Smart UserAgent Pool: Intelligent UserAgent rotation system with automatic failure recovery and performance monitoring
🌐 Multi-Platform: Complete iOS, iPadOS, macOS, watchOS, tvOS, and visionOS documentation support
🏷️ Beta & Status Tracking: iOS 26 beta APIs, deprecated UIKit methods, new SwiftUI features tracking
Related MCP server: Apple Deep Docs MCP
🚀 Quick Start
Claude Desktop (Recommended)
Add this to your Claude Desktop configuration:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"apple-docs": {
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
}
}
}Note: If you encounter issues with an old version being used, add
@latestto force the latest version:"args": ["-y", "@kimsungwhee/apple-docs-mcp@latest"]
Restart Claude Desktop and start asking about Apple APIs!
📦 Installation
claude mcp add apple-docs -- npx -y @kimsungwhee/apple-docs-mcp@latestVia Settings: Settings → Cursor Settings → MCP → Add new global MCP server
Via Config File: Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"apple-docs": {
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
}
}
}Add to your VS Code MCP config:
{
"mcp": {
"servers": {
"apple-docs": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
}
}
}
}Add to your Windsurf MCP config:
{
"mcpServers": {
"apple-docs": {
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
}
}
}Add to your Zed settings.json:
{
"context_servers": {
"Apple Docs": {
"command": {
"path": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
},
"settings": {}
}
}
}Via Marketplace:
Open Cline → Menu (☰) → MCP Servers → Marketplace
Search "Apple Docs MCP" → Install
Via Config: Add to cline_mcp_settings.json:
{
"mcpServers": {
"apple-docs": {
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"],
"disabled": false,
"autoApprove": []
}
}
}Via Config File: Add to ~/.aws/amazonq/mcp.json:
{
"mcpServers": {
"apple-docs": {
"command": "npx",
"args": ["-y", "@kimsungwhee/apple-docs-mcp"]
}
}
}📖 Amazon A Developer CLI MCP docs
For Windows systems, use:
{
"mcpServers": {
"apple-docs": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@kimsungwhee/apple-docs-mcp"],
"disabled": false,
"autoApprove": []
}
}
}Global Installation:
# Using pnpm (recommended)
pnpm add -g @kimsungwhee/apple-docs-mcp
# Using npm
npm install -g @kimsungwhee/apple-docs-mcpDirect Usage:
npx @kimsungwhee/apple-docs-mcp --helpDevelopment Setup:
git clone https://github.com/kimsungwhee/apple-docs-mcp.git
cd apple-docs-mcp
# Using pnpm (recommended)
pnpm install && pnpm run build
# Using npm
npm install && npm run build💬 Usage Examples
🔍 Smart Search
"Search for SwiftUI animations"
"Find withAnimation API documentation"
"Look up async/await patterns in Swift"
"Show me UITableView delegate methods"
"Search Core Data NSPersistentContainer examples"
"Find AVFoundation video playback APIs"📚 Documentation Access
"Get detailed information about the SwiftUI framework"
"Show me withAnimation API with related APIs"
"Get platform compatibility for SwiftData"
"Access UIViewController documentation with similar APIs"
"Show me NSManagedObjectContext documentation"
"Get URLSession async/await methods"🔧 Framework Exploration
"Show me SwiftUI framework API index"
"List all UIKit classes and methods"
"Browse ARKit framework structure"
"Get WeatherKit API hierarchy"
"Explore Core ML model loading APIs"
"Show Vision framework image analysis APIs"🔗 API Discovery
"Find APIs related to UIViewController"
"Show me similar APIs to withAnimation"
"Get all references from SwiftData documentation"
"Discover alternatives to Core Data NSManagedObject"📋 Technology & Platform Analysis
"List all Beta frameworks in iOS 26"
"Show me Graphics & Games technologies"
"What machine learning frameworks are available?"
"Analyze platform compatibility for Vision framework"📰 Documentation Updates
"Show me the latest WWDC updates"
"What's new in SwiftUI?"
"Get technology updates for iOS"
"Show me release notes for Xcode"
"Find beta features in the latest updates"🎯 Technology Overviews
"Show me technology overviews for app design and UI"
"Get comprehensive guides for games development"
"Explore AI and machine learning overviews"
"Show me iOS-specific technology guides"
"Get data management technology overviews"💻 Sample Code Library
"Show SwiftUI sample code projects"
"Find sample code for machine learning"
"Get UIKit example projects"
"Show featured WWDC sample code"
"Find Core Data sample implementations"
"Show only beta sample code projects"🎥 WWDC Video Search
"Search WWDC videos about SwiftUI"
"Find WWDC sessions on machine learning"
"Show me WWDC 2024 videos"
"Search for async/await WWDC talks"
"Find WWDC videos about Swift concurrency"
"Show accessibility-focused WWDC sessions"📺 WWDC Video Details
"Get details for WWDC session 10176"
"Show me the transcript for WWDC23 session on SwiftData"
"Get code examples from WWDC video 10019"
"Show resources from Vision Pro WWDC session"
"Get transcript for 'Meet async/await in Swift' session"📋 WWDC Topics & Years
"List all WWDC topics"
"Show me Swift topic WWDC videos"
"Get WWDC videos about developer tools"
"List WWDC videos from 2023"
"Show all SwiftUI and UI frameworks sessions"
"Get machine learning WWDC content"🛠️ Advanced Usage
"Find related APIs for @State with platform analysis"
"Resolve all references from SwiftUI documentation"
"Get platform compatibility analysis for Vision framework"
"Find similar APIs to UIViewController with deep search"🛠️ Available Tools
Tool | Description | Key Features |
| Search Apple Developer Documentation | Official search API, find specific APIs, classes, methods |
| Get detailed documentation content | JSON API access, optional enhanced analysis (related/similar APIs, platform compatibility) |
| Browse all Apple technologies | Category filtering, language support, beta status |
| Search symbols in specific framework | Classes, structs, protocols, wildcard patterns, type filtering |
| Find related APIs | Inheritance, conformance, "See Also" relationships |
| Batch resolve API references | Extract and resolve all references from documentation |
| Platform compatibility analysis | Version support, beta status, deprecation info |
| Discover similar APIs | Apple's official recommendations, topic groupings |
| Track Apple documentation updates | WWDC announcements, technology updates, release notes |
| Get technology overviews and guides | Comprehensive guides, hierarchical navigation, platform filtering |
| Browse Apple sample code projects | Framework filtering (with limitations), keyword search, beta status |
| Search WWDC video sessions | Keyword search, topic/year filtering, session metadata |
| Get WWDC video details with transcript | Full transcripts, code examples, resources, platform info |
| List all available WWDC topics | 19 topic categories from Swift to Spatial Computing |
| List all available WWDC years | Conference years with video counts |
🏗️ Technical Architecture for Apple Developer Documentation Access
apple-docs-mcp/
├── 🔧 src/
│ ├── index.ts # MCP server entry point with all tools
│ ├── tools/ # MCP tool implementations
│ │ ├── search-parser.ts # HTML search result parsing
│ │ ├── doc-fetcher.ts # JSON API documentation fetching
│ │ ├── list-technologies.ts # Technology catalog handling
│ │ ├── get-documentation-updates.ts # Documentation updates tracking
│ │ ├── get-technology-overviews.ts # Technology overviews and guides
│ │ ├── get-sample-code.ts # Sample code library browser
│ │ ├── get-framework-index.ts # Framework structure indexing
│ │ ├── get-related-apis.ts # Related API discovery
│ │ ├── resolve-references-batch.ts # Batch reference resolution
│ │ ├── get-platform-compatibility.ts # Platform analysis
│ │ ├── find-similar-apis.ts # Similar API recommendations
│ │ └── wwdc/ # WWDC video tools
│ │ ├── wwdc-handlers.ts # WWDC tool handlers
│ │ ├── content-extractor.ts # Video content extraction
│ │ ├── topics-extractor.ts # Topic listing
│ │ └── video-list-extractor.ts # Video list parsing
│ └── utils/ # Utility functions and helpers
│ ├── cache.ts # Memory cache with TTL support
│ ├── constants.ts # Application constants and URLs
│ ├── error-handler.ts # Error handling and validation
│ ├── http-client.ts # HTTP client with performance tracking
│ ├── user-agent-pool.ts # Smart UserAgent rotation system
│ ├── http-headers-generator.ts # Dynamic browser headers generation
│ └── url-converter.ts # URL conversion utilities
├── 📦 dist/ # Compiled JavaScript
├── 📄 package.json # Package configuration
└── 📖 README.md # This file🚀 Performance Features
Memory-Based Caching: Custom cache implementation with automatic cleanup and TTL support
Smart UserAgent Pool: Intelligent rotation system with automatic failure recovery and performance monitoring
Dynamic Headers: Realistic browser headers generation (Accept, Accept-Language, User-Agent)
Smart Search: Official Apple search API with enhanced result formatting
Enhanced Analysis: Optional related APIs, platform compatibility, and similarity analysis
Error Resilience: Graceful degradation with comprehensive error handling
Type Safety: Full TypeScript with Zod v4.0.5 runtime validation
Latest Dependencies: MCP SDK v1.15.1, optimized package footprint
💾 Caching Strategy
Content Type | Cache Duration | Cache Size | Reason |
API Documentation | 30 minutes | 500 entries | Frequently accessed, moderate updates |
Search Results | 10 minutes | 200 entries | Dynamic content, user-specific |
Framework Indexes | 1 hour | 100 entries | Stable structure, less frequent changes |
Technologies List | 2 hours | 50 entries | Rarely changes, large content |
Documentation Updates | 30 minutes | 100 entries | Regular updates, WWDC announcements |
📦 WWDC Data
All WWDC video data (2014-2025) is bundled directly in the npm package, providing:
✅ Zero network latency - No API calls needed for WWDC content
✅ 100% offline access - Works without internet connection
✅ No rate limits - Unlimited WWDC searches and browsing
✅ Instant responses - All data is locally available
The package includes:
📹 1,260+ WWDC session videos with full transcripts
🏷️ 20 topic categories for organized browsing
📅 13 years of content (2012-2025)
💾 35MB of optimized JSON data
Note: Keep your package updated to get the latest WWDC content additions.
⚙️ Configuration
🔄 UserAgent Pool Configuration
The MCP server includes an intelligent UserAgent rotation system to improve API reliability:
Environment Variables
Variable | Description | Default | Example |
| Enable/disable rotation |
|
|
| Rotation strategy |
|
|
| Max retry attempts |
|
|
| Custom pool config (JSON) | Built-in agents | See below |
Custom Pool Configuration
# Configure custom UserAgent pool
export USER_AGENT_POOL_CONFIG='[
{"userAgent": "MyApp/1.0 (compatible)", "weight": 3, "maxUsageCount": 1000},
{"userAgent": "MyApp/2.0 (advanced)", "weight": 2, "maxUsageCount": 800}
]'
# Set rotation strategy (random/sequential/smart)
export USER_AGENT_POOL_STRATEGY=smart
# Enable debugging
export NODE_ENV=developmentAvailable Strategies
random: Fast random selection (best performance)sequential: Round-robin rotation (predictable order)smart: Success rate optimization (best reliability)
Built-in UserAgents
The server includes 12+ pre-configured UserAgent strings covering:
Chrome (Mac Intel/Apple Silicon, Windows, Linux)
Firefox (Mac Intel/Apple Silicon, Windows, Linux)
Safari (Mac Intel/Apple Silicon, latest versions)
Edge (Windows, Mac Intel/Apple Silicon)
🧪 Development
Quick Commands
# Development with auto-reload
pnpm run dev # or: npm run dev
# Build for production
pnpm run build # or: npm run build
# Type checking
pnpm exec tsc --noEmit # or: npx tsc --noEmit
# Clean build artifacts
pnpm run clean # or: npm run cleanTesting Locally
# Test the MCP server directly
node dist/index.js
# Test with sample queries
npx @kimsungwhee/apple-docs-mcp --test🤝 Contributing
Contributions are welcome! Here's how to get started:
Fork the repository
Create a feature branch:
git checkout -b feature/amazing-featureCommit your changes:
git commit -m 'Add amazing feature'Push to the branch:
git push origin feature/amazing-featureOpen a Pull Request
📄 License
MIT License - see LICENSE for details.
⚠️ Disclaimer
This project is not affiliated with or endorsed by Apple Inc. It uses publicly available Apple Developer Documentation APIs for educational and development purposes.
Made with ❤️ for the Apple Developer Community
Search Apple Developer Documentation | iOS Development | macOS Development | Swift Programming | SwiftUI | UIKit | Xcode | WWDC Videos | Model Context Protocol | MCP Server
Available Tools
18 toolsbrowse_wwdc_topicsARead-only
List all WWDC topic categories with their IDs. Essential first step before using list_wwdc_videos with topic filtering. Returns topic IDs like "swiftui-ui-frameworks" that can be used in other tools.
Inputs: topicId, includeVideos, year, limit.
find_similar_apisARead-only
Discover alternative and related APIs. Finds APIs with similar functionality, modern replacements for deprecated APIs, and platform-specific alternatives. Perfect when looking for better ways to implement functionality.
Inputs: apiUrl (required), searchDepth, filterByCategory, includeAlternatives.
get_apple_doc_contentARead-only
Get detailed content from a specific Apple Developer Documentation page. Use this after search_apple_docs to get full documentation. Supports enhanced analysis options for comprehensive API understanding. Best for: reading API details, understanding usage, checking availability.
Inputs: url (required), includeRelatedApis, includeReferences, includeSimilarApis, +1 more.
get_documentation_updatesARead-only
Track latest Apple platform updates, new APIs, and changes. Shows WWDC announcements, framework updates, and release notes. Essential for staying current with Apple development. For detailed WWDC videos, use WWDC-specific tools.
Inputs: category, technology, year, searchQuery, +2 more.
get_platform_compatibilityARead-only
Check API availability across Apple platforms and OS versions. Shows minimum deployment targets, deprecations, and platform-specific features. Critical for cross-platform development. Use when: planning app requirements, checking API availability, finding platform alternatives.
Inputs: apiUrl (required), compareMode, includeRelated.
get_sample_codeARead-only
Browse complete sample projects from Apple. Full working examples demonstrating best practices and implementation patterns. Different from search_apple_docs which returns code snippets. Use for learning by example.
Inputs: framework, beta, searchQuery, limit.
get_technology_overviewsARead-only
Access comprehensive guides and tutorials for Apple technologies. Includes getting started guides, architectural overviews, best practices, and implementation patterns. Perfect for learning new frameworks or understanding Apple's recommended approaches.
Inputs: category, platform, searchQuery, includeSubcategories, +1 more.
get_wwdc_code_examplesARead-only
Browse all code examples from WWDC sessions. Perfect for finding implementation patterns, seeing new API usage, or learning by example. Each result includes the code and its session context.
Inputs: framework, topic, year, language, +1 more.
get_wwdc_videoARead-only
Access complete WWDC session content including full transcript, code examples, and resources. Use after finding videos with list_wwdc_videos or search_wwdc_content. Provides offline access to entire session content.
Inputs: year (required), videoId (required), includeTranscript, includeCode.
list_technologiesARead-only
Browse all Apple technologies and frameworks by category. Essential for discovering available frameworks and understanding Apple's technology ecosystem. Use this when: exploring what's available, finding framework identifiers for search_framework_symbols, checking beta status.
Inputs: category, language, includeBeta, limit.
list_wwdc_videosARead-only
Browse WWDC session videos with full offline access to transcripts and code. Shows all available sessions with filtering options. Use this to discover WWDC content, find sessions by topic, or identify videos with code examples.
Inputs: year, topic, hasCode, limit.
list_wwdc_yearsARead-only
List all available WWDC years with video counts and statistics. Shows which years have content available and how many videos each year contains.
Inputs: no named parameters.
resolve_references_batchARead-only
Deep dive into all types and APIs referenced in a documentation page. Resolves all mentioned types, methods, and properties to understand dependencies. Use when: analyzing complex APIs, understanding type requirements, exploring API ecosystems.
Inputs: sourceUrl (required), maxReferences, filterByType.
search_apple_docsARead-only
Search Apple Developer Documentation for APIs, frameworks, guides, and samples. Best for finding specific APIs, classes, or methods. For browsing sample code projects, use get_sample_code. For WWDC videos, use the dedicated WWDC tools (list_wwdc_videos, search_wwdc_content).
Inputs: query (required), type.
search_framework_symbolsARead-only
Browse and search symbols within a specific Apple framework. Perfect for exploring framework APIs, finding all views/controllers/delegates in a framework, or discovering available types. Use after list_technologies to get framework identifiers.
Inputs: framework (required), symbolType, namePattern, language, +1 more.
search_wwdc_contentARead-only
Full-text search across all WWDC video transcripts and code examples. Find specific discussions, API mentions, or implementation examples. More powerful than list_wwdc_videos for finding specific content.
Inputs: query (required), searchIn, year, language, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Each tool has a clearly distinct purpose, covering different aspects of Apple documentation and WWDC content. Tools like browse_wwdc_topics, list_wwdc_videos, and list_wwdc_years are unambiguously separate, and search tools are differentiated by source (docs, WWDC, framework symbols).
All tool names follow a consistent verb_noun pattern in snake_case (e.g., browse_wwdc_topics, get_apple_doc_content, list_technologies). The naming is predictable and readable, with no mixing of conventions.
18 tools cover a broad domain (Apple documentation, WWDC, framework browsing, sample code, platform compatibility) without being excessive. Each tool serves a clear purpose, and the count feels well-scoped for the intended functionality.
The tool set is comprehensive for exploring Apple developer resources. It covers search, navigation, getting content, related APIs, updates, and sample code. No obvious gaps for typical documentation tasks.
Maintenance
Related MCP Connectors
Find Apple docs and WWDC with RAG retrieval and Jev relevance ranking. Browse topics or read pages.
Search and read Apple developer documentation, HIG, and WWDC transcripts as Markdown.
Access and search Branch's official API documentation directly within any AI agent or client.
Provides AI assistants with direct access to Mapbox developer APIs and documentation.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceProvides AI agents with instant access to official Apple developer documentation, Swift programming guides, design guidelines, and Apple Developer YouTube content including WWDC sessions. Uses advanced RAG technology with semantic search and AI reranking to deliver accurate, contextual answers for Apple platform development.7-
- AlicenseNot gradedqualityDmaintenanceProvides comprehensive access to Apple's development documentation ecosystem including hidden Xcode docs, Swift Evolution proposals, GitHub repositories, and WWDC session notes. Enables developers to search and retrieve advanced Apple development resources not available through public channels.16MIT
- AlicenseBqualityFmaintenanceProvides AI assistants with access to Apple's Human Interface Guidelines and technical API documentation across all Apple platforms (iOS, macOS, watchOS, tvOS, visionOS), enabling unified search of design principles and implementation details.321MIT
- AlicenseNot gradedqualityBmaintenanceProvides access to Apple documentation and WWDC transcripts with semantic, keyword, and hybrid search capabilities, enabling developers to quickly find relevant code examples and technical information.116MIT