English Français العربية

SimBrief MCPServer

Community Maps, travel and weather

Access your SimBrief flight plans: weather (METAR/TAF/ATIS), fuel plan, weights, ATC flight plan, navlog, NOTAMs, alternates and performance analysis.

Source code Documentation

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. SimBrief MCP Server
  2. Features
  3. Requirements
  4. Installation
  5. Configuration
  6. Claude Desktop integration
  7. Usage examples
  8. Development
  9. Contributing
  10. License

SimBrief MCP Server

A Model Context Protocol server that gives Claude Desktop direct access to your SimBrief flight plans — no Cloudflare, no OAuth, no infrastructure required.

Features

14 tools covering every section of a SimBrief OFP:

ToolDescription
get_flight_summaryFlight number, aircraft, route, distance, cruise, ETE, fuel
get_weatherMETAR, TAF and ATIS for departure, arrival and alternate
get_fuel_planFull fuel breakdown: taxi, trip, contingency, alternate, reserve, extra
get_weightsOEW, payload, ZFW, TOW, ramp weight, landing weight
get_timesScheduled OUT/OFF/ON/IN, ETE, block time, taxi, endurance
get_atc_flightplanATC flight plan string ready for filing
get_aircraft_infoType, registration, engines, equipment codes
get_navlogFull waypoint list with altitude, distance and fuel per leg
get_notamsAll NOTAMs (departure, arrival, en-route)
get_alternate_infoAlternate airport details and navlog
get_performanceTakeoff & landing performance (TLR), if available
get_crewCaptain, first officer, dispatcher, purser, flight attendants
get_impactsFuel and time sensitivity to altitude and cost index changes
get_full_flight_planComplete raw JSON for custom analysis

All tools accept an optional plan_id parameter — leave it empty to always fetch your latest dispatch.

Requirements

Installation

git clone https://github.com/Emanuele94/SimBrief-MCPServer.git
cd SimBrief-MCPServer
uv sync

Configuration

Your SimBrief Pilot ID is passed via an environment variable in the MCP config — no code changes needed.

Find your Pilot ID under SimBrief → Account Settings → Pilot ID.

Claude Desktop integration

Add the following to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "simbrief": {
      "command": "uv",
      "args": [
        "run",
        "--project", "/absolute/path/to/SimBrief-MCPServer",
        "python",
        "/absolute/path/to/SimBrief-MCPServer/server.py"
      ],
      "env": {
        "SIMBRIEF_PILOT_ID": "your_pilot_id_here"
      }
    }
  }
}

Then restart Claude Desktop. The SimBrief tools will appear automatically.

The server will refuse to start with a clear error message if SIMBRIEF_PILOT_ID is not set.

Usage examples

Once connected, you can ask Claude things like:

  • "What's my latest flight plan?"
  • "Show me the weather for my next flight."
  • "How much fuel do I have planned and what's the breakdown?"
  • "Give me the full ATC flight plan string."
  • "What happens to fuel burn if I fly 2000 ft lower?"
  • "Show me the first 20 waypoints of my navlog."

Development

Install dev dependencies:

uv sync --all-extras

Run tests:

uv run pytest -v

Lint and format:

uv run ruff check .
uv run ruff format .

All tests run fully offline — the SimBrief API is mocked so no internet connection or real Pilot ID is required.

Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/my-feature)
  3. Make your changes and add tests
  4. Ensure the CI pipeline passes locally (uv run pytest && uv run ruff check .)
  5. Open a Pull Request against main

PRs must pass all checks (tests + lint) before they can be merged.

License

MIT

Frequently asked questions

What is SimBrief MCPServer?

Access your SimBrief flight plans: weather (METAR/TAF/ATIS), fuel plan, weights, ATC flight plan, navlog, NOTAMs, alternates and performance analysis.

How do I install SimBrief MCPServer?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is SimBrief MCPServer open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains SimBrief MCPServer?

It is published by Emanuele94. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.