Connect Claude Code to Crane Ledger

Claude Code can call Crane Ledger tools over Streamable HTTP MCP while you work in the terminal.

Prerequisites

  1. Claude Code installed and authenticated.
  2. A Crane Ledger API key (ha_live_…) from the dashboard or POST /accounts/master.
  3. Credits available (writes cost 1 credit each; reads are free).

MCP endpoint

SettingValue
URLhttps://api.craneledger.ai/mcp
TransportStreamable HTTP
Auth (OAuth)Sign in at consent UI — no key in the client
Auth (API key)Authorization: Bearer ha_live_…
Consenthttps://craneledger.ai/oauth/consent

Organization scope comes from your OAuth token or API key — you do not pass organization_id separately.

Scopes: ledger:read, ledger:write, and optionally ledger:admin.

See Authentication and MCP tools.

Add the MCP server

claude mcp add --transport http crane-ledger https://api.craneledger.ai/mcp \
  --header "Authorization: Bearer ha_live_your_key_here"

Verify the server appears in your Claude Code MCP list, then start a session and ask accounting questions.

OAuth note

Claude Code typically uses an API key header for remote HTTP MCP. For browser OAuth connectors, use Claude.ai or ChatGPT instead.

Example prompts

Once connected, try:

  • "Set up a basic chart of accounts for a small service business"
  • "Create an invoice for $2,500 to Acme Corp for consulting"
  • "What's our cash position right now?"
  • "Show me profit and loss for last quarter"
  • "How many credits do I have left?"

Troubleshooting

IssueWhat to try
Server not listedRe-run claude mcp add and confirm the transport is http
401Check the Authorization header value; regenerate the key if needed
Tool failuresConfirm credits and org scope on the key

Related

Need help?

Create a free account (GitHub, Google, Apple, or email) to access our support portal. Once signed in, use the Support tab in your dashboard to submit a support ticket — no GitHub account required. Our team typically responds within 24 hours.