@centry-digital/bukku-mcp 2.0.0 → 2.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +143 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
# Bukku MCP Server
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/@centry-digital/bukku-mcp)
|
|
4
|
+
|
|
5
|
+
An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that connects AI assistants to [Bukku](https://bukku.my), a Malaysian accounting platform. This gives your AI the ability to read, create, and manage your accounting data — invoices, bills, payments, contacts, products, and more.
|
|
6
|
+
|
|
7
|
+
## What can it do?
|
|
8
|
+
|
|
9
|
+
With this MCP server connected, you can ask your AI things like:
|
|
10
|
+
|
|
11
|
+
- "List my unpaid sales invoices"
|
|
12
|
+
- "Create an invoice for RM 5,000 to Acme Corp for consulting services"
|
|
13
|
+
- "Show me all purchase bills from last month"
|
|
14
|
+
- "Record a bank transfer of RM 10,000 from Maybank to CIMB"
|
|
15
|
+
- "Create a new contact for my supplier"
|
|
16
|
+
- "Upload this receipt and attach it to the purchase bill"
|
|
17
|
+
|
|
18
|
+
The server exposes **169 tools** covering the full Bukku API:
|
|
19
|
+
|
|
20
|
+
| Category | Tools | What you can do |
|
|
21
|
+
|----------|-------|-----------------|
|
|
22
|
+
| **Sales** | 42 | Quotes, orders, delivery orders, invoices, credit notes, payments, refunds |
|
|
23
|
+
| **Purchases** | 36 | Purchase orders, bills, credit notes, goods received notes, payments, refunds |
|
|
24
|
+
| **Banking** | 18 | Money in, money out, bank transfers |
|
|
25
|
+
| **Contacts** | 12 | Customers, suppliers, contact groups |
|
|
26
|
+
| **Products** | 18 | Products, product bundles, product groups |
|
|
27
|
+
| **Accounting** | 13 | Journal entries, chart of accounts |
|
|
28
|
+
| **Files** | 3 | Upload and manage file attachments |
|
|
29
|
+
| **Organisation** | 17 | Locations, tags, tag groups |
|
|
30
|
+
| **Reference Data** | 10 | Tax codes, currencies, payment methods, terms, and more |
|
|
31
|
+
|
|
32
|
+
## Quick Start
|
|
33
|
+
|
|
34
|
+
### Prerequisites
|
|
35
|
+
|
|
36
|
+
- [Node.js](https://nodejs.org) v20 or later
|
|
37
|
+
- A [Bukku](https://bukku.my) account with API access enabled
|
|
38
|
+
- An AI client that supports MCP (e.g. [Claude Desktop](https://claude.ai/download), [Claude Code](https://docs.anthropic.com/en/docs/claude-code))
|
|
39
|
+
|
|
40
|
+
### Step 1: Get your Bukku API token
|
|
41
|
+
|
|
42
|
+
1. Log into your Bukku account
|
|
43
|
+
2. Go to **Control Panel > Integrations > API Access**
|
|
44
|
+
3. Generate a new API token (or copy your existing one)
|
|
45
|
+
4. Note your company subdomain — e.g. `mycompany` from `mycompany.bukku.my`
|
|
46
|
+
|
|
47
|
+
### Step 2: Add to your AI client
|
|
48
|
+
|
|
49
|
+
**Claude Desktop** — open your config file:
|
|
50
|
+
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
51
|
+
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
|
|
52
|
+
|
|
53
|
+
```json
|
|
54
|
+
{
|
|
55
|
+
"mcpServers": {
|
|
56
|
+
"bukku": {
|
|
57
|
+
"command": "npx",
|
|
58
|
+
"args": ["-y", "@centry-digital/bukku-mcp"],
|
|
59
|
+
"env": {
|
|
60
|
+
"BUKKU_API_TOKEN": "your-token-here",
|
|
61
|
+
"BUKKU_COMPANY_SUBDOMAIN": "your-subdomain"
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
**Claude Code** — add to your project or home `.claude/settings.json`:
|
|
69
|
+
|
|
70
|
+
```json
|
|
71
|
+
{
|
|
72
|
+
"mcpServers": {
|
|
73
|
+
"bukku": {
|
|
74
|
+
"command": "npx",
|
|
75
|
+
"args": ["-y", "@centry-digital/bukku-mcp"],
|
|
76
|
+
"env": {
|
|
77
|
+
"BUKKU_API_TOKEN": "your-token-here",
|
|
78
|
+
"BUKKU_COMPANY_SUBDOMAIN": "your-subdomain"
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
### Step 3: Restart your AI client
|
|
86
|
+
|
|
87
|
+
Quit and reopen your AI client. You're ready to go.
|
|
88
|
+
|
|
89
|
+
## Installation
|
|
90
|
+
|
|
91
|
+
### npx (recommended)
|
|
92
|
+
|
|
93
|
+
No installation needed — downloads and runs the latest version:
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
npx @centry-digital/bukku-mcp
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
### npm global install
|
|
100
|
+
|
|
101
|
+
```bash
|
|
102
|
+
npm install -g @centry-digital/bukku-mcp
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
Then use `bukku-mcp` as the command in your AI client config instead of `npx`.
|
|
106
|
+
|
|
107
|
+
## Configuration
|
|
108
|
+
|
|
109
|
+
| Variable | Required | Description |
|
|
110
|
+
|----------|----------|-------------|
|
|
111
|
+
| `BUKKU_API_TOKEN` | Yes | Your Bukku API token from Control Panel > Integrations > API Access |
|
|
112
|
+
| `BUKKU_COMPANY_SUBDOMAIN` | Yes | Your company subdomain (e.g. `mycompany` from `mycompany.bukku.my`) |
|
|
113
|
+
|
|
114
|
+
## Troubleshooting
|
|
115
|
+
|
|
116
|
+
**"Configuration Error" on startup**
|
|
117
|
+
- Check that both `BUKKU_API_TOKEN` and `BUKKU_COMPANY_SUBDOMAIN` are set in your client config
|
|
118
|
+
|
|
119
|
+
**"Token validation failed"**
|
|
120
|
+
- Your API token may be invalid or expired — regenerate at Control Panel > Integrations > API Access
|
|
121
|
+
|
|
122
|
+
**Server doesn't appear in your AI client**
|
|
123
|
+
- Verify JSON syntax is correct (no trailing commas)
|
|
124
|
+
- Restart your AI client after editing the config
|
|
125
|
+
- Check Node.js v20+ is installed: `node --version`
|
|
126
|
+
|
|
127
|
+
## Uninstalling
|
|
128
|
+
|
|
129
|
+
If you installed globally:
|
|
130
|
+
|
|
131
|
+
```bash
|
|
132
|
+
npm uninstall -g @centry-digital/bukku-mcp
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
Then remove the `bukku` entry from your AI client's MCP config file.
|
|
136
|
+
|
|
137
|
+
## Related
|
|
138
|
+
|
|
139
|
+
- [GitHub repository](https://github.com/centry-digital/bukku)
|
|
140
|
+
|
|
141
|
+
## License
|
|
142
|
+
|
|
143
|
+
MIT
|