Skip to content

Gemini CLI

Freight Right is a Gemini CLI extension. Install the extension, start Gemini CLI, and sign in with your Shipment Manager login. There is no key or secret to paste.

Gemini CLI only

This works in Gemini CLI, the command-line tool, only. It does not work in the Gemini app on the web (gemini.google.com) or on mobile.

  1. Install Gemini CLI
    npm install -g @google/gemini-cli
    
    You need Node.js 20 or newer, and git for the next step. Other installers are on the Gemini CLI installation page.
  2. Install the Freight Right extension Run this in your terminal. It is not a command inside a Gemini CLI session.
    gemini extensions install https://github.com/freight-right/agent-plugins
    
    The extension installs the connector and the workflow guidance together. Its tool timeout is 60 seconds. A price check asks carriers live and can take that long.
  3. Start Gemini CLI
    gemini
    
    Complete Gemini CLI's own sign-in if it asks. Freight Right is a separate sign-in, in the next step.
  4. Sign in to Freight Right
    /mcp auth freightright
    
    Your browser opens Freight Right. Sign in with your Shipment Manager login, or create a free account on that page, and approve the list you are shown. There is no key or secret to paste. The server name is freightright.
  5. Ask about your freight Ask about a shipment, a price or a quote. Gemini CLI shows when it uses Freight Right.

Update the extension

Gemini CLI keeps a copy of the extension. To update it, run this in your terminal, then start Gemini CLI again:

gemini extensions update freightright

If the sign-in expires

Run /mcp auth freightright again and sign in with your Shipment Manager account.

Already added the connector by hand?

Remove it before you use the extension. Two copies of the same connector means two sign-ins and two sets of tools, and your assistant will not know which to use.

gemini mcp remove freight-right

That is the server name on the developer tools page. Run the command in the directory where you added the server. If you added it with --scope user, run gemini mcp remove --scope user freight-right. If you used a different name, remove that name instead.

Endpoints

Production Live
https://mcp.freightright.com/mcp

Your live Freight Right account: real shipments, real prices, real bookings. This is the URL used throughout these pages, and the one the agent plugins ship.

Staging Live
https://staging-mcp.sm.freightright.com/mcp

For developers testing an integration. Sign in with a staging Shipment Manager account; everything there is test data, and a booking placed there reaches nobody.