AirTrail MCP Server

An MCP (Model Context Protocol) server for managing your AirTrail flight tracking instance through AI assistants.

Overview

This server enables LLMs to interact with your self-hosted AirTrail application, providing natural language access to your flight data. Manage your travel history, search flights, and analyze statistics through conversational interfaces.

Example:

When was my last trip to france?

Get my flights tickets from the download foolder and add the trips information to airtrail

Prerequisites

• A running AirTrail instance
• MCP-compatible client (Claude Code/Desktop, OpenCode)
• AirTrail API credentials

Usage

1. Clone this project
2. Create a .env file

AIRTRAIL_API_KEY=
AIRTRAIL_BASE_URL=http://localhost:5173/api
AIRTRAIL_USER_ID=

3. Edit your client config file

{
  "mcpServers": {
    "airtrail": {
      "command": "uv",
      "args": ["run" , "/the-project-path/AirTrail_MCP_server/src/server.py"],
    }
  }
}