SimBrief

You run a Cloudflare‑based MCP server that provides SimBrief flight planning data to Claude Desktop and other MCP clients. It authenticates users with Google OAuth, serves data at the edge, and exposes MCP tools that help you access the latest flight plans, dispatch briefings, and plan details securely and quickly.

How to use

Connect your MCP client to the server to access SimBrief flight planning data. The server supports two transport modes: HTTP for remote MCP clients and STDIO for local or command‑line MCP integrations. With a typical setup, you authenticate via Google OAuth, then issue tool requests such as getting the latest flight plan, a specific flight plan by ID, or a dispatch briefing. Use the fully featured JSON data for in‑depth planning, or request summaries when you need a quick overview.

How to install

Prerequisites you need before setup:

• Node.js 18 or higher

• npm or yarn

• Cloudflare account

• SimBrief account and User ID

• Google OAuth credentials

Configuration and usage notes

The server is designed to run on Cloudflare Workers with Durable Objects for stateful sessions and uses Google OAuth to control access. You can optionally enable Sentry for error tracking and provide a SimBrief API key to improve rate limits.

Key files and configuration include access control and environment secrets. You will configure allowed users, set up OAuth credentials, and optionally provide an API key for SimBrief. The server exposes two MCP access methods: an HTTP URL you can point clients to, and a local STDIO command you can run via CLIs like npx.

Example client configurations

Local development integration for Claude Desktop (HTTP endpoint): you would point your local client to the local mcp endpoint.

Security and monitoring

Security features include OAuth 2.0 with Google, signed cookies for session persistence, email‑based access control, and sanitized error reporting. Optional monitoring can be enabled with Sentry. Edge deployment via Cloudflare Workers provides built‑in security and analytics.

Troubleshooting

If you encounter access issues, verify that your email is on the allowed list and that Google OAuth credentials are configured correctly. For API errors, confirm your SimBrief User ID is accurate and that you have a valid API key if you enable rate‑limit optimization.

Available tools

getLatestFlightPlan

Get complete JSON data for your latest flight plan, including NOTAMs, weather, crew alerts, MEL/CDL, and more. Used by default unless a summary is requested.

getFlightPlanById

Get complete JSON data for a specific flight plan by its 21‑character SimBrief plan ID.

getDispatchBriefing

Get a formatted dispatch briefing with operational information, including flight info, route, fuel planning, weights, and weather.

getLatestFlightPlanSummary

Get a concise summary of the latest flight plan for quick overviews.

getFlightPlanByIdSummary

Get a concise summary for a specific flight plan by its ID.