Global Entry Scanner

Scan for open Global Entry / NEXUS appointment slots and get notified the moment one appears.

CI PyPI

Works with

Claude Cursor Windsurf Gemini CLI GitHub Copilot VS Code

Install

# macOS
brew install pipx

# Linux
sudo apt install pipx       # Debian / Ubuntu
sudo dnf install pipx       # Fedora

# Windows
scoop install pipx          # or: winget install pipx

pipx install global-entry-scanner

Inside a virtual environment? pip install global-entry-scanner works too.

Quick start

global-entry-scanner setup   # pick locations + notification channels
global-entry-scanner scan    # start watching

CLI

global-entry-scanner locations                          # list all enrollment centers
global-entry-scanner scan --locations "Chicago, Dallas" # override locations
global-entry-scanner scan --notify email,slack          # override channels
global-entry-scanner mcp                                # start MCP server

MCP server

Works with Claude Desktop, Cursor, Windsurf, Gemini CLI, VS Code, and any MCP-compatible tool.

pipx install global-entry-scanner
global-entry-scanner mcp

Add to your AI tool's MCP config (see MCP Server wiki page for per-tool file paths):

{
  "mcpServers": {
    "global-entry-scanner": {
      "command": "global-entry-scanner",
      "args": ["mcp"]
    }
  }
}

Claude Code skill

Ask Claude to find slots, set up monitoring, or configure notifications in plain English — no commands needed.

/plugin marketplace add JaiminBrahmbhatt/Global-Entry-Appointment-Scanner
/plugin install global-entry-scanner@global-entry-scanner

Wiki

Full documentation lives in the wiki:

• Installation
• Quick Start
• Configuration
• Notification Channels — Email, Discord, Slack, SMS setup
• CLI Reference
• Python API
• MCP Server
• Claude Code Skill
• Developer Guide

Credits

Inspired by:

• https://gist.github.com/serg06/ac46defe2d9f568ac39665bd50d2e1b1
• https://gist.github.com/clay584/bcbbe3803ca6414ce09426a2c3d4abfb