Expo MCP Server

Model Context Protocol server for Expo.dev programmatically manage Expo projects and EAS services through AI assistants like Claude.

What It Does

This MCP server gives AI assistants full control over Expo/React Native development workflows:

Quick Start

Install via Smithery

npx @smithery/cli install expo-mcp-server

Or Add to MCP Config

{
  "mcpServers": {
    "expo-dev": {
      "command": "npx",
      "args": ["-y", "expo-mcp-server"],
      "env": {
        "EXPO_TOKEN": "your_token_here"
      }
    }
  }
}

Get your token at expo.dev/settings/access-tokens

Tools

Project Management

• expo_init_project Create new Expo projects with templates
• expo_install_packages Install packages with version validation
• expo_get_config View and validate app configuration
• expo_prebuild Generate native iOS/Android directories

EAS Build

• eas_build_create Trigger cloud builds (iOS, Android, or both)
• eas_build_list List builds with filtering
• eas_build_status Get build status and logs
• eas_build_cancel Cancel in-progress builds

EAS Update (OTA)

• eas_update_publish Publish over-the-air updates
• eas_update_list List published updates
• eas_channel_create Create update channels

EAS Submit

• eas_submit_ios Submit to App Store Connect/TestFlight
• eas_submit_android Submit to Google Play Console

Utilities

• expo_doctor Run project diagnostics
• expo_whoami Check authentication status
• eas_project_info Get EAS project metadata

Resources

The server exposes documentation as MCP resources:

expo://docs/llms           # Complete Expo docs (LLM-optimized)
expo://docs/eas-build      # EAS Build guide
expo://docs/eas-update     # EAS Update guide
expo://docs/eas-submit     # EAS Submit guide
expo://docs/cli-reference  # Expo CLI reference

Example Workflows

"Build my app for both platforms"

 eas_build_create(platform: "all", profile: "production")

"Push a hotfix to production"

 eas_update_publish(branch: "production", message: "Fix auth bug")

"Submit the latest build to TestFlight"

 eas_submit_ios(buildId: "abc-123")

Output Formats

All tools support:

• markdown (default) Human-readable tables
• json Structured data for processing

Development

git clone https://github.com/CaullenOmdahl/expo-mcp-server
cd expo-mcp-server
npm install
npm run build
npm run dev  # Run with Smithery playground

Architecture

src/
 index.ts              # Server entry point
 types.ts              # Shared schemas
 resources/            # Documentation resources
 tools/                # Tool implementations
    project.ts        # Project management
    build.ts          # EAS Build
    update.ts         # EAS Update
    submit.ts         # EAS Submit
 utils/                # CLI execution, formatting

Built with TypeScript, MCP SDK, and Zod validation.

Requirements

• Node.js 18+
• Expo account with access token

Links

• Expo Documentation
• EAS Documentation
• Model Context Protocol
• Smithery Registry

License

MIT