Bookkeeping CLI
Back to Guides
xAI Grok

xAI Grok Setup

Available

Connect Bookkeeping CLI to Grok two ways: paste a connector URL straight into the Grok app, or wire it up as a remote MCP tool in the xAI API/SDK. Either way, no local setup.

5 min read
Prerequisites
  • •An xAI API key from console.x.ai
  • •A Bookkeeping CLI account with your accounting software connected
  • •A Bookkeeping CLI API key from your dashboard

1
Get Your Bookkeeping CLI API Key

Go to your API Keys dashboard and create a new key. Copy it — you'll need it for the MCP authorization.

Get API Key

2
Connect Grok

In the Grok app (easiest): open grok.com/connectors → New Connector → Custom, and paste your connector URL: https://www.bookkeepingcli.com/api/mcp/YOUR_API_KEY. Your key is baked into the URL, so there's no OAuth form or login — it just connects. Your dashboard shows the full URL when you create a key.

In the xAI API/SDK: add the MCP server as a remote tool and pass your key as the authorization token, as shown below.

Code Examples
Use the xAI SDK or API directly to connect Grok to your accounting data.

Python (xai-sdk)

from xai_sdk import Client

client = Client()

response = client.responses.create(
    model="grok-3",
    input="List my unpaid invoices",
    tools=[
        {
            "type": "mcp",
            "server_url": "https://www.bookkeepingcli.com/api/mcp",
            "server_label": "bookkeeping",
            "authorization": "Bearer YOUR_API_KEY"
        }
    ]
)

print(response.output_text)

cURL

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-3",
    "input": "List my customers",
    "tools": [{
      "type": "mcp",
      "server_url": "https://www.bookkeepingcli.com/api/mcp",
      "server_label": "bookkeeping",
      "authorization": "Bearer YOUR_BOOKKEEPING_API_KEY"
    }]
  }'

What You Can Ask

Once connected, ask Grok about your accounting data in natural language:

List my unpaid invoices
Who are my top customers?
Show me overdue bills
What was my revenue this month?
290+ Accounting Tools
Access comprehensive accounting functionality across all supported providers:
Invoices & BillingContacts & CustomersProducts & ServicesBank & PaymentsReports & AnalyticsTax & VATDanish Legal Documents
CLI Skill Auto-Installed
Automatic
When you install the Bookkeeping CLI, a Grok instruction file is automatically placed at ~/.grok/instructions/bookkeeping-cli.md. This gives Grok full knowledge of all CLI commands, authentication, and provider-specific features.
Install CLI

Next Steps

You're all set! Here's what you can do now:

1
Connect your accounting software in the dashboard
2
Try asking Grok about your invoices and customers
3
Explore all available tools and capabilities
Go to Dashboard