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-mcpFor command line
Manage invoices, contacts, products, and more from your terminal. See the CLI package README for full documentation.
npx @centry-digital/bukku-cli --helpBoth 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-mcpIf 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-cacheStep 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 testMonorepo 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
