easybill-mcp 1.0.0 → 1.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 +197 -62
- package/dist/constants.d.ts +5 -1
- package/dist/constants.js +16 -1
- package/dist/constants.js.map +1 -1
- package/package.json +15 -1
package/README.md
CHANGED
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
# easybill MCP Server
|
|
2
2
|
|
|
3
3
|
An [MCP](https://modelcontextprotocol.io) server for the [easybill REST API](https://www.easybill.de/api/).
|
|
4
|
-
Gives
|
|
4
|
+
Gives any MCP-capable assistant — Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed,
|
|
5
|
+
Codex CLI, Gemini CLI, Cline — access to your invoices, customers, article catalogue, payments,
|
|
6
|
+
projects and tracked time.
|
|
5
7
|
|
|
6
8
|
Built on the official [`@modelcontextprotocol/sdk`](https://github.com/modelcontextprotocol/typescript-sdk)
|
|
7
9
|
(TypeScript), talking stdio.
|
|
@@ -22,118 +24,229 @@ Built on the official [`@modelcontextprotocol/sdk`](https://github.com/modelcont
|
|
|
22
24
|
|
|
23
25
|
In easybill: **Einstellungen → App-Center → API**. Create a key and copy it.
|
|
24
26
|
|
|
25
|
-
### 2.
|
|
27
|
+
### 2. Register it with your client
|
|
28
|
+
|
|
29
|
+
This is a plain stdio MCP server published on npm, so any MCP client can run it with `npx` —
|
|
30
|
+
no clone, no build, no global install:
|
|
26
31
|
|
|
27
32
|
```bash
|
|
28
|
-
|
|
29
|
-
cd easybill-mcp
|
|
30
|
-
npm install
|
|
31
|
-
npm run build
|
|
33
|
+
npx -y easybill-mcp
|
|
32
34
|
```
|
|
33
35
|
|
|
34
|
-
|
|
36
|
+
Configuration is entirely through environment variables (full list under
|
|
37
|
+
[Configuration](#configuration)). Two matter now:
|
|
35
38
|
|
|
36
|
-
|
|
39
|
+
- Leave `EASYBILL_ENABLE_WRITES` unset to start **read-only**.
|
|
40
|
+
- Set `EASYBILL_RATE_LIMIT_PER_MINUTE` to **10** on easybill's PLUS plan or **60** on BUSINESS.
|
|
41
|
+
|
|
42
|
+
Most clients use the same JSON shape under an `mcpServers` key:
|
|
43
|
+
|
|
44
|
+
```json
|
|
45
|
+
{
|
|
46
|
+
"mcpServers": {
|
|
47
|
+
"easybill": {
|
|
48
|
+
"command": "npx",
|
|
49
|
+
"args": ["-y", "easybill-mcp"],
|
|
50
|
+
"env": {
|
|
51
|
+
"EASYBILL_API_KEY": "your_api_key_here",
|
|
52
|
+
"EASYBILL_RATE_LIMIT_PER_MINUTE": "10"
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
Where that block goes:
|
|
60
|
+
|
|
61
|
+
| Client | Config location |
|
|
62
|
+
|---|---|
|
|
63
|
+
| **Claude Desktop** | Settings → Developer → Edit Config, or `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) · `%APPDATA%\Claude\claude_desktop_config.json` (Windows) |
|
|
64
|
+
| **Cursor** | `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per project) |
|
|
65
|
+
| **Windsurf** | `~/.codeium/windsurf/mcp_config.json` |
|
|
66
|
+
| **Cline / Roo Code** | MCP Servers panel → Configure MCP Servers (`cline_mcp_settings.json`) |
|
|
67
|
+
| **Gemini CLI** | `~/.gemini/settings.json` |
|
|
68
|
+
| **Claude Code** | `claude mcp add`, see below |
|
|
69
|
+
| **VS Code / Copilot** | `.vscode/mcp.json`, different key — see below |
|
|
70
|
+
| **Zed** | `settings.json` → `context_servers`, see below |
|
|
71
|
+
| **Codex CLI** | `~/.codex/config.toml`, TOML instead of JSON — see below |
|
|
72
|
+
|
|
73
|
+
> **Windows:** if a client fails to start `npx`, use `"command": "cmd"` with
|
|
74
|
+
> `"args": ["/c", "npx", "-y", "easybill-mcp"]`.
|
|
75
|
+
|
|
76
|
+
#### Claude Code
|
|
37
77
|
|
|
38
78
|
```bash
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
79
|
+
claude mcp add easybill \
|
|
80
|
+
--env EASYBILL_API_KEY=your_api_key_here \
|
|
81
|
+
--env EASYBILL_RATE_LIMIT_PER_MINUTE=10 \
|
|
82
|
+
-- npx -y easybill-mcp
|
|
42
83
|
```
|
|
43
84
|
|
|
44
|
-
|
|
85
|
+
`claude mcp add` does not overwrite an existing entry — to change the environment later,
|
|
86
|
+
`claude mcp remove easybill -s local` first, then add it again.
|
|
87
|
+
|
|
88
|
+
#### VS Code (GitHub Copilot agent mode)
|
|
89
|
+
|
|
90
|
+
VS Code uses `servers`, not `mcpServers`, and can prompt for the key instead of storing it
|
|
91
|
+
in the file. Put this in `.vscode/mcp.json` (workspace) or open **MCP: Open User
|
|
92
|
+
Configuration**:
|
|
45
93
|
|
|
94
|
+
```json
|
|
95
|
+
{
|
|
96
|
+
"inputs": [
|
|
97
|
+
{ "id": "easybill_key", "type": "promptString", "description": "easybill API key", "password": true }
|
|
98
|
+
],
|
|
99
|
+
"servers": {
|
|
100
|
+
"easybill": {
|
|
101
|
+
"type": "stdio",
|
|
102
|
+
"command": "npx",
|
|
103
|
+
"args": ["-y", "easybill-mcp"],
|
|
104
|
+
"env": {
|
|
105
|
+
"EASYBILL_API_KEY": "${input:easybill_key}",
|
|
106
|
+
"EASYBILL_RATE_LIMIT_PER_MINUTE": "10"
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
}
|
|
46
111
|
```
|
|
47
|
-
easybill-mcp-server v1.0.0 self-test
|
|
48
|
-
API: https://api.easybill.de/rest/v1
|
|
49
|
-
Throttle: 60 req/min | writes disabled
|
|
50
112
|
|
|
51
|
-
|
|
52
|
-
OK Customers: total=42 first=Example GmbH
|
|
53
|
-
OK Invoices: total=128 first=RE-2026-0001
|
|
54
|
-
OK Unpaid invoices: total=7 first=RE-2026-0117
|
|
55
|
-
OK Articles (positions): total=95 first=ART-001
|
|
113
|
+
#### Zed
|
|
56
114
|
|
|
57
|
-
|
|
115
|
+
In `settings.json`:
|
|
116
|
+
|
|
117
|
+
```json
|
|
118
|
+
{
|
|
119
|
+
"context_servers": {
|
|
120
|
+
"easybill": {
|
|
121
|
+
"source": "custom",
|
|
122
|
+
"command": "npx",
|
|
123
|
+
"args": ["-y", "easybill-mcp"],
|
|
124
|
+
"env": {
|
|
125
|
+
"EASYBILL_API_KEY": "your_api_key_here",
|
|
126
|
+
"EASYBILL_RATE_LIMIT_PER_MINUTE": "10"
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
}
|
|
58
131
|
```
|
|
59
132
|
|
|
60
|
-
|
|
133
|
+
#### Codex CLI
|
|
61
134
|
|
|
62
|
-
|
|
135
|
+
In `~/.codex/config.toml`:
|
|
63
136
|
|
|
64
|
-
|
|
137
|
+
```toml
|
|
138
|
+
[mcp_servers.easybill]
|
|
139
|
+
command = "npx"
|
|
140
|
+
args = ["-y", "easybill-mcp"]
|
|
141
|
+
env = { EASYBILL_API_KEY = "your_api_key_here", EASYBILL_RATE_LIMIT_PER_MINUTE = "10" }
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
#### Hosted clients that only speak remote MCP
|
|
145
|
+
|
|
146
|
+
Some clients (ChatGPT connectors, hosted agent platforms) accept only HTTP/SSE endpoints, not
|
|
147
|
+
stdio. Bridge it locally:
|
|
65
148
|
|
|
66
149
|
```bash
|
|
67
|
-
|
|
150
|
+
npx -y supergateway --stdio "npx -y easybill-mcp"
|
|
68
151
|
```
|
|
69
152
|
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
153
|
+
Only do this if you understand the exposure: anything that reaches that endpoint reaches your
|
|
154
|
+
accounting data. Keep it bound to localhost or behind a tunnel with authentication, and never
|
|
155
|
+
run the bridge with writes enabled unless the endpoint is protected.
|
|
73
156
|
|
|
74
|
-
###
|
|
157
|
+
### 3. Verify the connection
|
|
75
158
|
|
|
76
|
-
|
|
159
|
+
Ask the assistant to call `easybill_get_server_info`. It reports the mode, the limits and
|
|
160
|
+
whether easybill accepted the credentials:
|
|
77
161
|
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
162
|
+
```json
|
|
163
|
+
{
|
|
164
|
+
"server_version": "1.0.1",
|
|
165
|
+
"writes_enabled": false,
|
|
166
|
+
"tools_registered": { "read_only": 28, "write": 0, "withheld_because_writes_disabled": 26 },
|
|
167
|
+
"rate_limit_per_minute": 10,
|
|
168
|
+
"connection": "ok — credentials accepted by easybill"
|
|
169
|
+
}
|
|
83
170
|
```
|
|
84
171
|
|
|
85
|
-
|
|
172
|
+
### 4. Enable writes, once you trust it
|
|
173
|
+
|
|
174
|
+
Add `EASYBILL_ENABLE_WRITES=true` to the server's environment:
|
|
86
175
|
|
|
87
176
|
```bash
|
|
88
177
|
claude mcp add easybill \
|
|
89
178
|
--env EASYBILL_API_KEY=your_api_key_here \
|
|
90
179
|
--env EASYBILL_RATE_LIMIT_PER_MINUTE=10 \
|
|
91
180
|
--env EASYBILL_ENABLE_WRITES=true \
|
|
92
|
-
--
|
|
181
|
+
-- npx -y easybill-mcp
|
|
93
182
|
```
|
|
94
183
|
|
|
95
|
-
|
|
184
|
+
The 26 write tools are registered at startup, so the change only takes effect once the client
|
|
185
|
+
restarts the server process — editing the config in a running session is not enough. Confirm
|
|
186
|
+
with `easybill_get_server_info`: `writes_enabled` must read `true`.
|
|
187
|
+
|
|
188
|
+
---
|
|
189
|
+
|
|
190
|
+
## Running from a local clone
|
|
96
191
|
|
|
97
|
-
|
|
192
|
+
For development, or to run a version you have not published:
|
|
98
193
|
|
|
194
|
+
```bash
|
|
195
|
+
git clone https://github.com/stack74/easybill-mcp.git
|
|
196
|
+
cd easybill-mcp
|
|
197
|
+
npm install
|
|
198
|
+
npm run build
|
|
99
199
|
```
|
|
100
|
-
|
|
200
|
+
|
|
201
|
+
Then point the client at the built entry point instead of `npx` — `"command": "node"`,
|
|
202
|
+
`"args": ["/absolute/path/to/easybill-mcp/dist/index.js"]`, same `env` block. Or straight from
|
|
203
|
+
GitHub without cloning, which is slower because it compiles TypeScript on install via the
|
|
204
|
+
`prepare` script and needs a toolchain:
|
|
205
|
+
|
|
206
|
+
```bash
|
|
207
|
+
npx -y github:stack74/easybill-mcp
|
|
101
208
|
```
|
|
102
209
|
|
|
103
|
-
###
|
|
210
|
+
### Test locally first
|
|
104
211
|
|
|
105
|
-
|
|
212
|
+
Copy `.env.example` to `.env`, put your key in it, then run the read-only self-test:
|
|
106
213
|
|
|
107
|
-
```
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
"command": "node",
|
|
112
|
-
"args": ["/absolute/path/to/easybill-mcp/dist/index.js"],
|
|
113
|
-
"env": {
|
|
114
|
-
"EASYBILL_API_KEY": "your_api_key_here",
|
|
115
|
-
"EASYBILL_RATE_LIMIT_PER_MINUTE": "10"
|
|
116
|
-
}
|
|
117
|
-
}
|
|
118
|
-
}
|
|
119
|
-
}
|
|
214
|
+
```bash
|
|
215
|
+
cp .env.example .env
|
|
216
|
+
$EDITOR .env
|
|
217
|
+
npm run smoke
|
|
120
218
|
```
|
|
121
219
|
|
|
122
|
-
|
|
220
|
+
It makes five read-only calls and prints what came back:
|
|
123
221
|
|
|
124
|
-
|
|
222
|
+
```
|
|
223
|
+
easybill-mcp-server v1.x.y self-test
|
|
224
|
+
API: https://api.easybill.de/rest/v1
|
|
225
|
+
Throttle: 60 req/min | writes disabled
|
|
125
226
|
|
|
126
|
-
|
|
127
|
-
|
|
227
|
+
OK Auth check (customer groups): total=2 first=Stammkunden
|
|
228
|
+
OK Customers: total=42 first=Example GmbH
|
|
229
|
+
OK Invoices: total=128 first=RE-2026-0001
|
|
230
|
+
OK Unpaid invoices: total=7 first=RE-2026-0117
|
|
231
|
+
OK Articles (positions): total=95 first=ART-001
|
|
232
|
+
|
|
233
|
+
All probes passed. The server is ready to register with an MCP client.
|
|
128
234
|
```
|
|
129
235
|
|
|
130
|
-
|
|
131
|
-
|
|
236
|
+
(Numbers above are illustrative — you will see your own account's totals.)
|
|
237
|
+
|
|
238
|
+
On a bad key it fails on the first call and stops, so it never burns your rate limit.
|
|
239
|
+
|
|
240
|
+
To poke at individual tools interactively:
|
|
132
241
|
|
|
133
242
|
```bash
|
|
134
|
-
|
|
243
|
+
npm run inspect # MCP Inspector, loads .env
|
|
135
244
|
```
|
|
136
245
|
|
|
246
|
+
> **Note:** `.env` is only read by these npm scripts, via Node's `--env-file`. The server
|
|
247
|
+
> itself reads plain environment variables — when you register it with an MCP client, pass
|
|
248
|
+
> the key through the client's config, not via `.env`.
|
|
249
|
+
|
|
137
250
|
### Publishing to npm
|
|
138
251
|
|
|
139
252
|
```bash
|
|
@@ -318,11 +431,33 @@ spelling or page through and match locally.
|
|
|
318
431
|
```bash
|
|
319
432
|
npm run build # compile to dist/
|
|
320
433
|
npm run typecheck # tsc --noEmit
|
|
434
|
+
npm test # offline suite — 37 tests, no credentials needed
|
|
435
|
+
npm run test:live # read-only tests against a real account (needs .env)
|
|
436
|
+
npm run test:all # both
|
|
321
437
|
npm run dev # watch mode
|
|
322
438
|
npm run smoke # read-only self-test against the live API (needs .env)
|
|
323
439
|
npm run inspect # MCP Inspector against the built server (needs .env)
|
|
324
440
|
```
|
|
325
441
|
|
|
442
|
+
### Tests
|
|
443
|
+
|
|
444
|
+
`npm test` runs offline and needs no easybill account — it covers response shaping,
|
|
445
|
+
the HTTP client against a mock API, the rate-limit throttle, and the MCP surface
|
|
446
|
+
(schemas, annotations, write-gating, error handling) driven over the real stdio protocol.
|
|
447
|
+
|
|
448
|
+
```
|
|
449
|
+
test/
|
|
450
|
+
├── helpers/mcp-client.mjs minimal MCP stdio client + mock API server
|
|
451
|
+
├── format.test.mjs field selection, pagination, truncation, markdown
|
|
452
|
+
├── client.test.mjs auth headers, query serialisation, 429 retry, error mapping
|
|
453
|
+
├── rate-limit.test.mjs sliding-window throttle
|
|
454
|
+
├── server.test.mjs tool registration, workflow guidance, validation, errors
|
|
455
|
+
└── live.test.mjs optional: read-only checks against a real account
|
|
456
|
+
```
|
|
457
|
+
|
|
458
|
+
`live.test.mjs` skips itself unless `EASYBILL_API_KEY` is set, so contributors without an
|
|
459
|
+
account still get a green suite. It only reads — nothing in the test suite writes to easybill.
|
|
460
|
+
|
|
326
461
|
Project layout:
|
|
327
462
|
|
|
328
463
|
```
|
package/dist/constants.d.ts
CHANGED
|
@@ -2,7 +2,11 @@
|
|
|
2
2
|
/** Overridable so the server can be pointed at a proxy or a test double. */
|
|
3
3
|
export declare const API_BASE_URL: string;
|
|
4
4
|
export declare const SERVER_NAME = "easybill-mcp-server";
|
|
5
|
-
|
|
5
|
+
/**
|
|
6
|
+
* Read from package.json rather than duplicated here, so `--version`, the MCP
|
|
7
|
+
* serverInfo and the published package can never disagree.
|
|
8
|
+
*/
|
|
9
|
+
export declare const SERVER_VERSION: string;
|
|
6
10
|
/** Maximum characters in a single tool response before it gets truncated. */
|
|
7
11
|
export declare const CHARACTER_LIMIT: number;
|
|
8
12
|
/** HTTP request timeout. */
|
package/dist/constants.js
CHANGED
|
@@ -1,8 +1,23 @@
|
|
|
1
1
|
/** Shared constants and runtime configuration for the easybill MCP server. */
|
|
2
|
+
import { createRequire } from "node:module";
|
|
2
3
|
/** Overridable so the server can be pointed at a proxy or a test double. */
|
|
3
4
|
export const API_BASE_URL = (process.env.EASYBILL_BASE_URL?.trim() || "https://api.easybill.de/rest/v1").replace(/\/+$/, "");
|
|
4
5
|
export const SERVER_NAME = "easybill-mcp-server";
|
|
5
|
-
|
|
6
|
+
/**
|
|
7
|
+
* Read from package.json rather than duplicated here, so `--version`, the MCP
|
|
8
|
+
* serverInfo and the published package can never disagree.
|
|
9
|
+
*/
|
|
10
|
+
export const SERVER_VERSION = (() => {
|
|
11
|
+
try {
|
|
12
|
+
const require = createRequire(import.meta.url);
|
|
13
|
+
// dist/constants.js -> ../package.json
|
|
14
|
+
const pkg = require("../package.json");
|
|
15
|
+
return pkg.version ?? "0.0.0";
|
|
16
|
+
}
|
|
17
|
+
catch {
|
|
18
|
+
return "0.0.0";
|
|
19
|
+
}
|
|
20
|
+
})();
|
|
6
21
|
function intFromEnv(name, fallback, min) {
|
|
7
22
|
const raw = process.env[name];
|
|
8
23
|
if (!raw)
|
package/dist/constants.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,iCAAiC,CAC3E,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAEtB,MAAM,CAAC,MAAM,WAAW,GAAG,qBAAqB,CAAC;
|
|
1
|
+
{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "easybill-mcp",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.2",
|
|
4
4
|
"description": "MCP server for the easybill REST API (invoices, customers, articles, payments, time tracking)",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -18,15 +18,29 @@
|
|
|
18
18
|
"start": "node dist/index.js",
|
|
19
19
|
"dev": "tsx watch src/index.ts",
|
|
20
20
|
"typecheck": "tsc --noEmit",
|
|
21
|
+
"test": "npm run build && node --test test/format.test.mjs test/client.test.mjs test/rate-limit.test.mjs test/server.test.mjs",
|
|
22
|
+
"test:live": "npm run build && node --env-file=.env --test test/live.test.mjs",
|
|
23
|
+
"test:all": "npm run test && npm run test:live",
|
|
21
24
|
"smoke": "node --env-file=.env dist/index.js --selftest",
|
|
22
25
|
"inspect": "npx @modelcontextprotocol/inspector node --env-file=.env dist/index.js",
|
|
23
26
|
"clean": "rm -rf dist"
|
|
24
27
|
},
|
|
25
28
|
"keywords": [
|
|
26
29
|
"mcp",
|
|
30
|
+
"mcp-server",
|
|
27
31
|
"modelcontextprotocol",
|
|
28
32
|
"model-context-protocol",
|
|
29
33
|
"claude",
|
|
34
|
+
"claude-code",
|
|
35
|
+
"claude-desktop",
|
|
36
|
+
"cursor",
|
|
37
|
+
"vscode",
|
|
38
|
+
"copilot",
|
|
39
|
+
"windsurf",
|
|
40
|
+
"zed",
|
|
41
|
+
"codex",
|
|
42
|
+
"gemini-cli",
|
|
43
|
+
"cline",
|
|
30
44
|
"easybill",
|
|
31
45
|
"invoice",
|
|
32
46
|
"invoicing",
|