How to Connect Brex to Gemini via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Brex, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Brex + Gemini

Let your AI read your Brex account: cards, card and business account transactions, statements, expenses, budgets, spend limits, vendors, users and trips. Read-only API token; it cannot send money. Card lock and expense memo actions are optional and off by default.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

BREX_API_TOKEN

Step 1 — Get credentials

It cannot move money, by design. The connector has no tool for transfers, payments, bill pay, ACH, wires, checks, new cards or limit changes, not even a switched-off one. Asking the AI to pay someone will not work. Your finance team gets answers about spend without opening a new way for money to leave the account.

1. Sign in to https://dashboard.brex.com as an account admin or card admin and open Developer, then Settings. Accept the developer API terms if Brex asks.
2. Click Create Token, give it a name such as AnythingMCP and select only the read-only scopes the connector uses: companies.readonly, users.readonly, departments.readonly, locations.readonly, cards.readonly, accounts.card.readonly, accounts.cash.readonly, transactions.card.readonly, transactions.cash.readonly, statements.card.readonly, statements.cash.readonly, expenses.card.readonly, budgets.readonly, vendors.readonly, travel.trips.readonly. Leave out the ones you do not need; the matching tools then answer 403.
3. Never select transfers, incoming_transfers or cards.pan. They let software move money or read full card numbers, and this connector needs neither.
4. Click Allow Access, copy the token (it starts with bxt_) into BREX_API_TOKEN and install the connector. Brex shows the token only once.
5. Check the setup with brex_get_company: it shows your company's legal name and account type.

Read-only token: a token with only .readonly scopes cannot change anything in Brex.

Switched off at install: brex_lock_card and brex_unlock_card (for a lost card or suspected fraud; the card owner is notified) and brex_update_expense_memo (writes the business purpose and overwrites the old memo). To use them, an admin creates a token that also has the cards scope for the card actions or expenses.card for the memo, and switches the tool on. The AI then shows you the card name and last four digits, or the expense and the new memo, and waits for your yes. Brex's cards scope would also let other software issue cards; this connector has no such tool.

Financial data is sensitive: balances, transactions, expenses, cards and employee details are confidential company data. Share the MCP server only with people allowed to see them; the AI reads only what you ask for. Full card numbers, CVCs and bank account and routing numbers are never returned: cards show the last four digits, and the bank details of accounts and vendors are removed.

What it reads: company, users, departments and locations; cards with their spend controls; card account balances and limit, settled card transactions and card statements; business (cash) accounts with their transactions and statements; expenses (card, bill pay and reimbursement) with receipts and compliance status, where DUE and OVERDUE find expenses still missing a receipt or memo; budgets and spend limits with what has been spent; vendors; and Brex Travel trips. Pending card authorizations are not included, and Brex can post a transaction a few days late.

Amounts: Brex gives amounts in the smallest currency unit, so 700 in USD means 7.00 USD. The AI converts them before showing them.

Limits and tokens: 1,000 requests per 60 seconds per account. A token unused for 90 days expires, and a token stops working when its user is no longer active. You can revoke it at any time under Developer, Settings. Brex has no sandbox, so the connector always reads live data.

Common errors: 401, or 403 "Invalid or Revoked Token": the token is wrong, revoked or expired; create a new one. 403 on some tools only: the token lacks that tool's scope, or its user lacks the Brex role (most data needs an account admin). 404: the id does not exist in this Brex account. 429: wait a minute.

The connector does not move money, issue or terminate cards, change limits or budgets, approve expenses, upload receipts or manage users and webhooks.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Gemini

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
2. Save the file and restart gemini.
3. Run /mcp inside Gemini CLI (or gemini mcp list in your shell): anythingmcp should show as connected.
4. Start prompting: Gemini CLI can now call the Brex tools.

Available tools

Example prompts

• "Which card expenses from last month are still missing a receipt or a memo? Group them by employee."
• "List last month's settled card transactions over 1,000 USD with merchant, card holder and date."
• "What is the current balance and available limit of our Brex card account, and when does the statement period end?"
• "Which spend limits have already used more than 80 percent of this period's limit?"
• "Which Brex Travel trips start next week? Show traveler, trip name and dates."

FAQ

Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.

Next steps

• Connector landing page
• Connect to Claude
• Connect to ChatGPT