Bukku

Tools for the Bukku accounting platform.

Packages

Package	Description	npm
@centry-digital/bukku-mcp	MCP server for AI assistants (Claude, etc.)
@centry-digital/bukku-cli	Command-line interface

Quick Start

For AI assistants (MCP)

Connect your AI client to the Bukku API. See the MCP package README for setup instructions.

npx @centry-digital/bukku-mcp

For command line

Manage invoices, contacts, products, and more from your terminal. See the CLI package README for full documentation.

npx @centry-digital/bukku-cli --help

Both packages require a Bukku API token and company subdomain. See Getting Your API Token.

Uninstalling

Step 1: Remove the MCP server configuration

Remove the "bukku" entry from the "mcpServers" object in your AI client's config file.

Claude Code: Remove from .claude/settings.json in your project directory (or ~/.claude/settings.json if added globally).

Claude Desktop: Remove from your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

After editing, restart your AI client for the changes to take effect.

Step 2: Remove the package (if installed globally)

If you installed the package globally with npm install -g, uninstall it:

npm uninstall -g @centry-digital/bukku-mcp

If you were using npx (the default Quick Start method), there is no persistent installation to remove — npx downloads the package temporarily each time it runs. You can optionally clear the npx cache:

npx clear-npx-cache

Step 3: Revoke your API token (optional)

If you no longer need API access, log into your Bukku account and revoke the token at Control Panel > Integrations > API Access.

Development

Prerequisites

• Node.js v20 or later

Setup

git clone https://github.com/centry-digital/bukku.git
cd bukku
npm install
npm run build
npm test

Monorepo Structure

packages/
  core/   Shared API client, entities, and types (internal)
  mcp/    MCP server package (@centry-digital/bukku-mcp)
  cli/    CLI package (@centry-digital/bukku-cli)

Both mcp and cli depend on core, which is bundled at build time and not published separately.

License

MIT