DeepLedger
Menu
← All articlesConnect an agent

Connect an agent

Connect Grok to Bill.com: Setup Guide for Every Entity

Connect Grok to Bill.com for all your entities with one DeepLedger custom connector or the xAI API. Switch entities by asking; nothing is paid or approved.

Published by DeepLedgerUpdated 7 min read

Grok connects to Bill.com through DeepLedger's hosted MCP server: add one custom connector at grok.com/connectors and Grok can read and draft in Bill.com for every entity you manage, switching entities when you ask. Developers can run the same tools from the xAI Responses API. DeepLedger never pays, approves or sends anything in Bill.com.

What you are connecting

https://mcp.deepledger.ai/mcp

One address serves QuickBooks Online, Xero (beta), Bill.com, and Stripe for reporting. Bill.com is an optional app on a DeepLedger company, next to its QuickBooks Online or Xero books, connected by an owner or admin on the company's Connections tab with your own BILL credentials.

RouteBest forSigns in with
Grok custom connectorAd hoc AP and AR questions in Grok chatYour DeepLedger sign-in
Grok Business or EnterpriseTeams, once an admin adds itEach member's own sign-in
xAI Responses APIScheduled reports your own code runsA DeepLedger API key

Why one sign-in for all your entities

A connection fixed to one organization chosen at sign-in does not fit work across more than one entity.

With DeepLedger, the connector belongs to you, not to one BILL organization. Grok reaches every company you can access, each with its own Bill.com organization and its own books, and moves between them in the conversation. The same connector also reaches those companies' QuickBooks Online or Xero books, so Grok can check Bill.com against the ledger without a second connection.

Before you start

  • A DeepLedger account (14-day trial, no card).
  • Each entity set up as a DeepLedger company with QuickBooks Online or Xero, and Bill.com connected on its Connections tab.
  • For chat: the Custom option at grok.com/connectors; see xAI's connector documentation.
  • For the API: an xAI API key and a DeepLedger API key.
  • Pricing: $20 per connection per month for QuickBooks Online, Xero (beta) and Bill.com, and $10 for Stripe, with unlimited users and a 14-day free trial with no credit card. See pricing.

How do I connect Grok to Bill.com?

  1. Open grok.com/connectors.
  2. Choose New Connector, then Custom.
  3. Paste https://mcp.deepledger.ai/mcp.
  4. Sign in with your DeepLedger account. You do not sign in to BILL.
  5. In a new chat, ask:

Which company am I in, and which of my companies have Bill.com connected?

On Grok Business and Enterprise, an admin adds the connector first in the xAI console under Grok Business → Connectors → Add Connector → Other. See xAI's connector management guide.

Already connected DeepLedger in Grok for QuickBooks? Bill.com appears in the same connector once a company connects it. The Grok and QuickBooks guide covers Grok Bot as well.

Switch companies by asking

List my companies with Bill.com.

Switch to Summit Property Group and show Bill.com bills awaiting approval.

Now do the same for Summit Property Services LLC.

DeepLedger's companies tool runs current, list and switch (by name or id). Use the exact company name. If a name matches more than one company, or none, DeepLedger refuses the switch; ask the AI to list your companies and switch by the company id. The active company is shared with every AI app you use, so confirm it when you move between apps.

A weekly AP digest with the xAI API

A useful pattern for controllers: one summary each Monday of what is due in every entity. Create a DeepLedger API key under Settings → API keys → Create key. For a report that should never write, have a read-only member create it, since a key acts with its creator's access.

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.6",
    "input": [{"role": "user", "content": "List my companies with Bill.com. For each one in turn, switch to it and list Bill.com bills due in the next 7 days with vendor, amount, currency and approval status."}],
    "tools": [{
      "type": "mcp",
      "server_url": "https://mcp.deepledger.ai/mcp",
      "server_label": "deepledger",
      "authorization": "'"$DEEPLEDGER_API_KEY"'",
      "allowed_tools": ["companies", "billcomFetchTransactions", "billcomMasterData"]
    }]
  }'

allowed_tools narrows what this request offers the model; it is not a permission. Field names follow xAI's remote MCP documentation. Your own scheduler runs the job; DeepLedger acts only when called.

Two rules when the job covers several entities:

  • Sequential is fine with an All my companies key: the agent switches, reads, and moves on. Do not run another session that switches at the same time.
  • Parallel needs pinning. Give each job a One company key, or send an X-Organization-Id header on every request. A pinned request cannot switch.

Multi-entity prompts to try

Due this week

For each company with Bill.com, list bills due this week and the total per currency. Never add different currencies together.

Approval status

Which Bill.com bills across my companies are still unassigned for approval? Group by company.

AR follow-up

Switch to Summit Property Services LLC and list Bill.com invoices more than 45 days overdue. Draft reminder text here; do not send anything.

Bill.com against the books

In Summit Property Group, compare open Bill.com bills with open bills in Xero for the same vendors and list any mismatches.

Intercompany

List Bill.com bills in Summit Property Services LLC from Summit Property Group, and the matching invoices on the other side, for October.

Draft a vendor credit

In Summit Property Group, create a Bill.com vendor credit for the attached credit note from Ridge Roofing. Do not apply it yet.

Is it safe to let Grok work in Bill.com?

  • No money moves. DeepLedger never pays, approves or sends anything in Bill.com, records payments, or changes approval workflows.
  • Duplicates are refused, and DeepLedger refuses a bill for a vendor BILL pays automatically (AutoPay), or when it cannot tell; a person enters those in BILL.
  • Dry runs show a write's exact request before anything reaches BILL.
  • Per-person access. Read-only members cannot write; Audit history records each call per company.
  • A warning for the wrong entity when a company's Bill.com organization does not match the country or currency of its books.
  • Revoke the connector at grok.com/connectors, the grant under Settings → Connected apps, the key under Settings → API keys, or disconnect Bill.com on the company's Connections tab.

Troubleshooting

No Custom option. On Business and Enterprise an admin adds the connector first.

API authentication error. authorization must carry the DeepLedger key (starting dl_live_), not the xAI key.

"Switch not allowed." The key is pinned to one company or the request carries X-Organization-Id.

"Bill.com is not connected." That company has no Bill.com connection; an owner or admin adds it.

Frequently asked questions

How do I connect Grok to Bill.com?

Through DeepLedger's MCP server. Connect Bill.com to each company in DeepLedger with your own BILL credentials, then open grok.com/connectors, choose New Connector, then Custom, and paste https://mcp.deepledger.ai/mcp. Sign in to DeepLedger and ask Grok which company is active.

Does DeepLedger's Bill.com connection work with Grok?

Yes. DeepLedger's server works in Grok today through a custom connector, for every entity you can access.

Can Grok switch between entities in Bill.com?

Yes. Each DeepLedger company has its own Bill.com connection, and one Grok connector reaches every company you can access. Ask Grok to switch to a company by name and its Bill.com data is what Grok reads next.

Can a Grok agent run a weekly AP report for several entities?

Yes, through the xAI Responses API. Add DeepLedger as an mcp tool with a DeepLedger API key. Run the entities one after another with an All my companies key, or give each parallel job a One company key so it cannot switch.

Will Grok pay bills in Bill.com?

No. DeepLedger never pays, approves or sends anything in Bill.com, never records payments and never changes approval workflows. Approvals and payments stay in BILL with the people you authorize.

See AI platforms and integrations for every app and pricing per connection.

Ready to get started?

Connect QuickBooks and try your first task with an AI agent.

Create an Account