Files

T

188816652d docs(api,mcp): tool counts, changelog backfill, version-header honesty, lazy auth, endpoint map (#1929 )

Brings the developer-facing API and MCP docs back in line with origin/main
(audit 2026-08-26). Docs only; no runtime behaviour changes.

- Tool counts: the server registers 153 tools; docs said 90+/100+/120.
  All now say "150+" (connect-claude, gnubok-mcp README, plugin README,
  mcp-server rules, CLAUDE.md, registry entry with refreshed updatedAt).
  Not derived from the tools array: lib/ must not import @/extensions/.
- REST changelog: backfilled the additive 2026-08 changes (#1909 report
  date ranges + PDFs, #1864 POST /companies, #1773 vat-declarations,
  #1405 PATCH settings, #1724/#1788 customer personal_number, #1809
  cash_account_id filter). API version date unchanged.
- Version headers: Gnubok-Deprecation is planned, not emitted; the
  Gnubok-Version request header is not read today (version.ts comment,
  versioning page, conventions overlay, regenerated skills/accounted-api).
- connect-claude Path A documents lazy auth (connector works before an
  account exists; sign-in on the first company-scoped call).
- MCP server README: real Anthropic SDK call sites, real resource URIs,
  pending-operations widget, public-tools/tasks/origin-guard/pii-guard.
  Rules file gains Lazy auth + feedback/tasks paragraphs.
- api-routes endpoint map regenerated from the filesystem (560 routes,
  55 families incl. v1, agent, reconciliation account-keyed, dimensions,
  peppol, rot-rut, webshop-orders, mileage, billing, skatteverket,
  receipt-hunt).
- gnubok-mcp/accounted-mcp: /settings?tab=api is the pre-redesign URL;
  now /settings/api (README + help hints, no version bump).

Co-authored-by: Jakob Wennberg <311770904+jakobwennberg-oss@users.noreply.github.com>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

2026-08-26 13:35:54 +02:00

__tests__

Bug/invalid imports (#1146 )

2026-07-24 15:03:50 +02:00

index.mjs

docs(api,mcp): tool counts, changelog backfill, version-header honesty, lazy auth, endpoint map (#1929 )

2026-08-26 13:35:54 +02:00

package.json

Bug/invalid imports (#1146 )

2026-07-24 15:03:50 +02:00

README.md

docs(connector): name the Claude.ai auth mode and OAuth client to pick (#1914 )

2026-08-26 08:58:02 +02:00

README.md

accounted-mcp

Connect Claude Desktop, Claude Code, or another stdio MCP client to your Accounted bookkeeping account.

This zero-dependency bridge forwards JSON-RPC over stdio to the hosted Accounted MCP server. New connections receive the accounted_* tool namespace. Existing gnubok-mcp configurations remain supported separately.

Setup

Create an API key in Accounted under Settings > API.
Add the bridge to your MCP client:

{
  "mcpServers": {
    "accounted": {
      "command": "npx",
      "args": ["-y", "accounted-mcp"],
      "env": {
        "ACCOUNTED_API_KEY": "gnubok_sk_test_...",
        "ACCOUNTED_CLIENT": "claude-desktop"
      }
    }
  }
}

The credential value retains the legacy gnubok_sk_* wire prefix for backward compatibility. Only the MCP integration is being renamed in this release.

Environment variables

Variable	Required	Default	Description
`ACCOUNTED_API_KEY`	yes	none	Your existing Accounted API key.
`ACCOUNTED_URL`	no	Accounted hosted MCP endpoint	Override for self-hosted Accounted. The bridge adds `tool_namespace=accounted` when omitted.
`ACCOUNTED_CLIENT`	no	none	Telemetry-only distribution marker such as `claude-desktop`.

The API key scopes determine which tools are visible and callable. Write tools stage pending operations for explicit approval before anything is booked.

OAuth connector (no API key, no account needed up front)

Clients with OAuth support connect directly without this bridge and without an existing API key. The sign-in screen lets a new user create the Accounted account (BankID or e-mail), and company setup then continues in the conversation through the onboarding skill and accounted_create_company:

https://app.accounted.se/api/extensions/ext/mcp-server/mcp?tool_namespace=accounted

# Claude Code
claude mcp add --transport http accounted \
  "https://app.accounted.se/api/extensions/ext/mcp-server/mcp?tool_namespace=accounted"

# OpenAI Codex
codex mcp add accounted --url \
  "https://app.accounted.se/api/extensions/ext/mcp-server/mcp?tool_namespace=accounted"

Claude.ai and Claude Desktop: Settings > Connectors > Add custom connector, paste the URL, then in step 2 choose:

Authentication: "Required when the server asks." Claude auto-detects "None" because the server answers the handshake without credentials; with "None" the first company-scoped call shows an error instead of the sign-in.
OAuth client: "No client ID, register one automatically" (DCR). The server does not advertise Anthropic's hosted client metadata (CIMD) yet.
No additional headers; transport stays Streamable HTTP.

The connector works before you connect (documentation tools); the first company-scoped call opens the sign-in prompt, where a new user creates the account.

Compatibility

The legacy gnubok-mcp package, environment variables, endpoint behavior, and gnubok_* tool aliases remain supported. Existing installations do not need to change.