How to Connect BILL (Bill.com) to Cursor via MCP

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

BILL (Bill.com) + Cursor

BILL (Bill.com) accounts payable and receivable: vendors, bills, recurring bills, vendor credits, bill approvals and approval policies, AP payments, customers, invoices, credit memos and received payments. BILL v3 API with a developer key and user sign-in; approving bills is included but installed switched off.

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:

BILL_API_URL, BILL_DEV_KEY, BILL_ORGANIZATION_ID, BILL_USERNAME, BILL_PASSWORD

Step 1 — Get credentials

1. BILL API access needs a developer key. An administrator generates it in the BILL web app under Settings → Sync & Integrations → Manage Developer Keys → Generate developer key. To try it first, sign up for a sandbox developer account at https://developer.bill.com, which comes with a sandbox key. Paste the key into BILL_DEV_KEY.
2. Copy the organization id from the bottom of the same Manage Developer Keys page into BILL_ORGANIZATION_ID. It starts with 008.
3. Enter the e-mail and password of a BILL user of that organization in BILL_USERNAME and BILL_PASSWORD. Use a dedicated API user: its role in BILL limits what the AI can see and do.
4. Set BILL_API_URL to https://gateway.prod.bill.com/connect for production or to https://gateway.stage.bill.com/connect for the sandbox. A sandbox developer key does not work on production, and the reverse.
5. Install the connector and run bill_com_get_session first. It checks the sign-in and shows the organization and user the connector works as.

Sessions: the connector signs in as that user and handles the session by itself. A session ends after 35 minutes without activity, and the connector simply signs in again.

What it reads: BILL (formerly Bill.com) runs accounts payable and receivable for US businesses. On the payables side the AI reads vendors, bills with due dates and payment and approval status, recurring bills, vendor credits, payments made to vendors, approval policies and the bills waiting for your approval. On the receivables side it reads customers, invoices, credit memos and payments received.

Good places to start: ask for the unpaid and partly paid bills sorted by due date, the bills waiting for your approval, or the customer invoices that are still open or partly paid.

Approvals are switched off at install: bill_com_approve_or_deny_bills approves or denies bills that wait for the signed-in user's approval, with an optional comment per bill, and approved bills can then be paid. Turn it on only if the AI should approve bills for that user; it starts from the list in bill_com_list_pending_approvals. Everything else is read-only.

Limits: 20,000 requests per developer key per hour, 3 concurrent requests per organization and 200 sign-ins per developer key per hour. The errors BDC_1144 and BDC_1322 mean a limit was reached: wait and retry.

The connector does not make payments and does not create bills or invoices.

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 Cursor

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.

Cursor reads MCP servers from ~/.cursor/mcp.json. Add this entry:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Open Cursor → Settings → MCP and check that anythingmcp is listed and connected.
4. Start chatting: the agent can now call the BILL (Bill.com) tools.

Available tools

Example prompts

• "Which bills are unpaid or partly paid, sorted by due date, and how much falls due in the next 14 days?"
• "Which bills are waiting for my approval, from which vendors and for how much?"
• "List the open customer invoices that are past their due date, with the amount still owed."
• "Which vendor payments went out this month, and which bills did they settle?"

FAQ

Does Cursor support custom MCP servers on the free tier? Yes, MCP is available on Hobby, Pro and Business plans.

Next steps

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