home / mcp / apple deep docs mcp server

Apple Deep Docs MCP Server

A Model Context Protocol server that exposes Apple's hidden Xcode documentation and developer resources

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ahrentlov-appledeepdoc-mcp": {
      "command": "/path/to/appledeepdoc-mcp/run.sh",
      "args": []
    }
  }
}

You gain a dedicated MCP server that exposes hidden Xcode documentation, Apple Developer resources, Swift Evolution proposals, WWDC notes, and Human Interface Guidelines. It consolidates these sources into an accessible interface you can query from your MCP client, enabling fast, centralized access to deep Apple documentation.

How to use

You interact with the server through your MCP client as a local or remote endpoint. Start by running the MCP server, then connect your client to the local stdio endpoint to issue queries like retrieving full documents, listing available docs, or searching Apple Developer content. You can search hidden Xcode documentation, fetch Apple Developer pages, and explore Swift Evolution proposals and WWDC notes through dedicated tool channels.

Typical usage patterns include: - Search and retrieve a specific document from Xcode’s hidden docs or Apple Developer docs. - List available documentation files or fetch versioned Xcode doc sets installed on your machine. - Explore Swift Evolution proposals to understand the rationale behind language features. - Look up WWDC session notes for performance tips and architectural patterns. - Cross-reference Human Interface Guidelines when designing apps for Apple platforms.

How to install

# Prerequisites
- Python 3.10+
- Xcode installed for local documentation

# 1) Clone the MCP server repository
git clone https://github.com/Ahrentlov/appledeepdoc-mcp.git
cd appledeepdoc-mcp

# 2) Set up Python environment
python3 -m venv venv
./venv/bin/pip install fastmcp

# 3) Ensure the run script is executable for the MCP server
chmod +x /path/to/appledeepdoc-mcp/run.sh

Configuration and usage notes

The MCP server is configured as a local stdio endpoint that you run from your environment. The recommended setup uses a local run script that launches the Python-based server within a virtual environment. You can integrate this server with Claude Code, Claude Desktop, or GPT-Codex by registering the stdio transport with the provided run script path.

Key environment variable you may override is: - XCODE_DOC_PATH: Override the default Xcode documentation search path if you want to point the server at a specific Xcode installation or documentation bundle.

Examples and quick start

# Claude Code integration (stdio)
chmod +x /path/to/appledeepdoc-mcp/run.sh
claude mcp add --transport stdio apple-deep-docs /path/to/appledeepdoc-mcp/run.sh
claude mcp list

# Claude Desktop configuration (JSON)
{
  "mcpServers": {
    "apple-deep_docs": {
      "command": "/path/to/appledeepdoc-mcp/run.sh",
      "args": []
    }
  }
}

Security and maintenance

Keep your Python environment isolated, periodically update dependencies, and ensure that access to the MCP server is restricted to your trusted clients. Regularly verify that the Xcode path and Apple documentation sources are reachable from the server host.

Available tools

search_docs

Search Xcode's hidden documentation

get_document

Retrieve full content of a specific document

list_documents

List all available documentation files

get_xcode_versions

Get installed Xcode versions with documentation

fetch_apple_documentation

Fetch structured docs from Apple Developer site

search_apple_online

Search both local and online Apple documentation

get_framework_info

Get direct documentation URL for any framework

search_swift_evolution

Search Swift Evolution proposals

get_swift_evolution_proposal

Get details of a specific Swift Evolution proposal

search_swift_repos

Search across Swift repositories on GitHub

fetch_github_file

Fetch source code from GitHub repositories

search_wwdc_notes

Search WWDC session notes and transcripts

get_wwdc_session

Get WWDC session URLs by ID

search_human_interface_guidelines

Search Apple's Human Interface Guidelines

list_human_interface_guidelines_platforms

List platforms with HIG links