██████  ███████ ██████  ██████  ███████         ███████ ██      ███████
██   ██ ██   ██ ██   ██ ██   ██   ███           ██      ██        ███
██████  ███████ ██████  ██████    ███           ██      ██        ███
██  ██  ██   ██ ██      ██        ███           ██      ██        ███
██   ██ ██   ██ ██      ██      ███████         ███████ ███████ ███████

Order from Rappi directly from the terminal, via REST API, or as an MCP server for Claude. Built with Bun, TypeScript, Zod, and Hono.

Install

# From npm (requires Bun)
bun add -g rappi-cli

# Or clone and link
git clone https://github.com/camilocbarrera/rappi-cli.git
cd rappi-cli
bun install
bun link

Setup

rappi login       # Opens browser — log in with your Rappi account

Or manually set your token:

rappi setup <bearer-token> [lat] [lng]

CLI Usage

# Browse
rappi search "hamburguesa"              # Search products and stores
rappi restaurants 20                     # List nearby restaurants
rappi store 900006505                    # Store details and menu
rappi product 900006505 3522980          # Product options (toppings)

# Order
rappi add-to-cart 900006505 3522980 "McCombo" 1 "3525800"
rappi cart                               # View current cart
rappi tip 2000                           # Set delivery tip (COP)
rappi checkout                           # Preview order summary
rappi place-order                        # Place the order!
rappi orders                             # Track active orders

# Account
rappi whoami                             # User info + Prime status
rappi addresses                          # List saved addresses
rappi addresses set <id>                 # Set delivery address

REST API

rappi server    # Starts on http://localhost:3100

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /api/whoami | User info + Prime status | | GET | /api/search?q=pizza | Search products and stores | | GET | /api/restaurants?limit=20 | Nearby restaurants | | GET | /api/store/:id | Store detail + menu | | GET | /api/product/:storeId/:productId | Product toppings | | POST | /api/cart/add | Add to cart | | GET | /api/cart | View cart | | POST | /api/cart/recalculate | Recalculate totals | | POST | /api/tip | Set tip | | GET | /api/checkout | Checkout preview | | POST | /api/place-order | Place order | | GET | /api/orders | Track orders | | GET | /api/addresses | List addresses | | POST | /api/addresses/set | Set address |

MCP Server (Claude Integration)

The Rappi CLI includes an MCP (Model Context Protocol) server that lets Claude use Rappi tools natively — no CLI commands needed.

Setup for Claude Code

Add .mcp.json to your project root:

{
  "mcpServers": {
    "rappi": {
      "command": "bun",
      "args": ["run", "/path/to/rappi-cli/src/mcp/index.ts"]
    }
  }
}

Setup for Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "rappi": {
      "command": "/path/to/.bun/bin/bun",
      "args": ["run", "/path/to/rappi-cli/src/mcp/index.ts"]
    }
  }
}

Use the full path to bun for Claude Desktop (run which bun to find it).

Available Tools

| Tool | Description | |------|-------------| | whoami | User profile + Prime status | | search | Search products and stores | | list_restaurants | Nearby restaurants | | get_store | Store detail + menu | | get_product_options | Product toppings/customization | | add_to_cart | Add to cart with toppings and price | | get_cart | View current cart | | checkout_preview | Order summary with price breakdown | | set_tip | Set delivery tip | | place_order | Place the order | | track_orders | Track active orders | | list_addresses | List saved addresses | | set_address | Set delivery address |

Architecture

src/
  constants.ts       → URLs, headers, defaults
  http.ts            → Typed HTTP helpers (get/post/put)
  config.ts          → Config load/save with Zod validation
  formatters.ts      → Price formatting (COP)
  schemas/           → Zod schemas (auth, address, search, store, product, cart, checkout, order)
  services/          → Business logic (shared by CLI, API + MCP)
  api/app.ts         → Hono REST API
  mcp/index.ts       → MCP server (13 tools for Claude)
  commands/          → CLI commands
index.ts             → CLI entry point
server.ts            → API server entry point

Tech Stack

• Bun — Runtime
• TypeScript — Type safety
• Zod — Schema validation
• Hono — REST API framework
• Playwright — Browser login automation
• MCP SDK — Claude integration (13 tools)