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:

Category	Capabilities
Project Setup	Initialize projects, install packages, configure apps, generate native code
Cloud Builds	Trigger iOS/Android builds, monitor progress, view logs, cancel builds
OTA Updates	Publish updates to branches, manage channels, instant deployments
App Submission	Submit to App Store Connect and Google Play Console
Diagnostics	Run health checks, validate configurations

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