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