@expensebot/mcp-server-auth 0.6.17 → 0.6.19
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 +18 -5
- package/package.json +19 -3
- package/scripts/descriptions.generated.json +10 -0
- package/src/client.js +1 -1
- package/src/index.js +38 -1
- package/src/test.js +2 -1
package/README.md
CHANGED
|
@@ -1,15 +1,21 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<a href="https://www.expensebot.ai/mcp">
|
|
3
|
+
<img src="https://raw.githubusercontent.com/TotesMagotes/expensebot-mcp/main/assets/expensebot.png" alt="ExpenseBot logo" width="160" height="160">
|
|
4
|
+
</a>
|
|
5
|
+
</p>
|
|
6
|
+
|
|
1
7
|
# @expensebot/mcp-server-auth
|
|
2
8
|
|
|
3
|
-
Authenticated MCP (Model Context Protocol) server for [ExpenseBot](https://www.expensebot.ai). Lets
|
|
9
|
+
Authenticated MCP (Model Context Protocol) server for [ExpenseBot](https://www.expensebot.ai). Lets Copilot, Gemini, Replit, Cursor, Claude Desktop, Claude Code, Continue, Cline, Windsurf, and other MCP-compatible assistants search receipts, submit photos and PDFs, scan Gmail, create reports, and analyze spending using your real ExpenseBot account.
|
|
4
10
|
|
|
5
|
-
**
|
|
11
|
+
**51 tools** across:
|
|
6
12
|
- **Search & analytics** — `search_expenses`, `get_spending_summary`, `get_deep_analytics`, `list_categories`, `list_tags`, `list_income_categories`, `search_knowledge`
|
|
7
13
|
- **Income & P&L** *(v0.6.0)* — `get_income_summary`, `get_pnl`, `get_per_tag_pnl`
|
|
8
14
|
- **Mileage & Subscriptions** *(v0.6.1)* — `get_mileage_summary`, `get_subscription_audit`
|
|
9
15
|
- **Receipt and expense capture** — `submit_receipt` (photo/PDF), `get_last_receipt_result`, `add_cash_expense` (including confirmed client advances), `add_mileage_entry`, `add_income`, `add_income_from_file` (screenshot/PDF, parse-preview-confirm), `add_income_from_csv` (CSV/TSV/text, parse-preview-confirm), `parse_expense`, `get_expense_by_id`, `update_expense`, `group_expenses`, `correct_expenses`, `get_spreadsheet_url`
|
|
10
16
|
- **Gmail** — `scan_gmail`, `process_gmail_receipts`, `scan_gmail_years`, `get_scan_status`
|
|
11
17
|
- **Reports & invoicing** — `create_report`, `list_reports`, `get_report_details`, `share_report`, `export_report`, `list_client_invoices`
|
|
12
|
-
- **Expense review** — `get_expense_splits`, `get_monthly_books_review`, `get_credits_refunds`
|
|
18
|
+
- **Expense review** — `get_expense_splits`, `get_monthly_books_review`, `get_credits_refunds`, `get_client_advance_balances`
|
|
13
19
|
- **Compliance & tax** — `check_compliance`, `fix_compliance`, `check_tax_deductibility`
|
|
14
20
|
- **Activity, tracing & onboarding** — `get_recent_activity`, `trace_document`, `get_signup_link`, `get_pricing`, `check_feature`, `start_trial_link`
|
|
15
21
|
- **Business what-if** — `whatif_afford`, `whatif_client`, `whatif_tax_setaside`
|
|
@@ -95,6 +101,11 @@ https://mcp.expensebot.ai/mcp
|
|
|
95
101
|
|
|
96
102
|
Complete ExpenseBot sign-in and consent in the browser. No personal token or manual OAuth client secret is needed. If the client supports only local/stdio MCP, use the npm setup above. Never email a token or paste it into an AI conversation.
|
|
97
103
|
|
|
104
|
+
This repository publishes both connection methods in `server.json`: the remote
|
|
105
|
+
Streamable HTTP server for OAuth-capable clients and the npm stdio package for
|
|
106
|
+
local clients. Host directories may expose either or both depending on their
|
|
107
|
+
transport and authentication support.
|
|
108
|
+
|
|
98
109
|
## Token model
|
|
99
110
|
|
|
100
111
|
- **Personal Access Tokens (PAT)** scoped to your ExpenseBot account
|
|
@@ -103,9 +114,11 @@ Complete ExpenseBot sign-in and consent in the browser. No personal token or man
|
|
|
103
114
|
- All actions audit-logged server-side
|
|
104
115
|
- Tokens stored as SHA-256 hashes; CASA Tier 2 certified
|
|
105
116
|
|
|
106
|
-
##
|
|
117
|
+
## Discovery
|
|
107
118
|
|
|
108
|
-
- **Official MCP Registry** —
|
|
119
|
+
- **Official MCP Registry** — active as
|
|
120
|
+
`io.github.TotesMagotes/mcp-server-auth`; version `0.6.19` is the current
|
|
121
|
+
listing with both npm stdio and remote Streamable HTTP transports
|
|
109
122
|
- **awesome-mcp-servers** — Finance & Fintech section
|
|
110
123
|
- **Glama** — <https://glama.ai/mcp/servers/TotesMagotes/expensebot>
|
|
111
124
|
|
package/package.json
CHANGED
|
@@ -1,8 +1,16 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@expensebot/mcp-server-auth",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.19",
|
|
4
4
|
"mcpName": "io.github.TotesMagotes/mcp-server-auth",
|
|
5
|
-
"description": "
|
|
5
|
+
"description": "ExpenseBot MCP server for receipt and income capture, Gmail scans, spending analytics, and reviewed expense reports from AI assistants.",
|
|
6
|
+
"homepage": "https://www.expensebot.ai/mcp",
|
|
7
|
+
"repository": {
|
|
8
|
+
"type": "git",
|
|
9
|
+
"url": "git+https://github.com/TotesMagotes/expensebot-mcp.git"
|
|
10
|
+
},
|
|
11
|
+
"bugs": {
|
|
12
|
+
"url": "https://github.com/TotesMagotes/expensebot-mcp/issues"
|
|
13
|
+
},
|
|
6
14
|
"bin": {
|
|
7
15
|
"expensebot-mcp-auth": "src/index.js"
|
|
8
16
|
},
|
|
@@ -21,6 +29,10 @@
|
|
|
21
29
|
"receipts",
|
|
22
30
|
"ai",
|
|
23
31
|
"claude",
|
|
32
|
+
"chatgpt",
|
|
33
|
+
"gemini",
|
|
34
|
+
"copilot",
|
|
35
|
+
"bookkeeping",
|
|
24
36
|
"accounting"
|
|
25
37
|
],
|
|
26
38
|
"engines": {
|
|
@@ -36,6 +48,10 @@
|
|
|
36
48
|
"gen-descriptions": "node scripts/generate-descriptions-from-kb.js",
|
|
37
49
|
"prepublishOnly": "node scripts/sync-check.js && node src/test.js"
|
|
38
50
|
},
|
|
39
|
-
"author":
|
|
51
|
+
"author": {
|
|
52
|
+
"name": "ExpenseBot",
|
|
53
|
+
"email": "support@expensebot.ai",
|
|
54
|
+
"url": "https://www.expensebot.ai"
|
|
55
|
+
},
|
|
40
56
|
"license": "MIT"
|
|
41
57
|
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
{
|
|
2
|
+
"_meta": {
|
|
3
|
+
"generatedAt": "2026-05-07T05:13:24.014Z",
|
|
4
|
+
"sourceKb": "../server/config/kb/entries/income-and-pnl-analytics.md",
|
|
5
|
+
"note": "Auto-generated from KB. Do NOT edit by hand — re-run `npm run gen-descriptions` after the KB changes."
|
|
6
|
+
},
|
|
7
|
+
"get_income_summary": "Get income totals and breakdowns from the Income tab — Schedule C / T2125 basis. Excludes Schedule B (interest, dividends), tax refunds, and security deposits (mirrors year-end report routing). Examples: \"How much income YTD?\", \"Income by source\", \"by month\", \"by payment method\".",
|
|
8
|
+
"get_pnl": "Compute Profit & Loss across the Income tab and expenses. Examples: \"Am I profitable this year?\", \"Net income last quarter\", \"What's my margin?\", \"P&L for Q1\".",
|
|
9
|
+
"get_per_tag_pnl": "Per-tag P&L — revenue, cost, profit, and margin grouped by tag. Requires both income AND expense rows to be tagged consistently. Examples: ."
|
|
10
|
+
}
|
package/src/client.js
CHANGED
|
@@ -46,7 +46,7 @@ export class ExpenseBotClient {
|
|
|
46
46
|
headers: {
|
|
47
47
|
Authorization: `Bearer ${this.token}`,
|
|
48
48
|
"Content-Type": "application/json",
|
|
49
|
-
"User-Agent": "expensebot-mcp-auth/0.6.
|
|
49
|
+
"User-Agent": "expensebot-mcp-auth/0.6.19",
|
|
50
50
|
"X-ExpenseBot-MCP-Transport": "stdio",
|
|
51
51
|
...options.headers,
|
|
52
52
|
},
|
package/src/index.js
CHANGED
|
@@ -1729,6 +1729,34 @@ const TOOLS = [
|
|
|
1729
1729
|
},
|
|
1730
1730
|
},
|
|
1731
1731
|
},
|
|
1732
|
+
{
|
|
1733
|
+
name: "get_client_advance_balances",
|
|
1734
|
+
description:
|
|
1735
|
+
"Read the same per-client advance balances shown in ExpenseBot's Open " +
|
|
1736
|
+
"Balances section. Use for questions like 'how much of Acme's advance " +
|
|
1737
|
+
"remains?', 'which client floats are still open?', or 'do I owe a client " +
|
|
1738
|
+
"a refund?'. A negative ledger balance means money remains to refund; a " +
|
|
1739
|
+
"positive balance means the client owes the user. Returns the existing " +
|
|
1740
|
+
"app handoff for Refund leftover or Bill Client. Read-only: never records " +
|
|
1741
|
+
"a refund, creates an invoice, or recomputes the ledger in model prose.",
|
|
1742
|
+
inputSchema: {
|
|
1743
|
+
type: "object",
|
|
1744
|
+
properties: {
|
|
1745
|
+
clientEmail: CLIENT_EMAIL_SCHEMA,
|
|
1746
|
+
clientName: {
|
|
1747
|
+
type: "string",
|
|
1748
|
+
description:
|
|
1749
|
+
"Optional client name or canonical Client tag. Omit to list all open balances.",
|
|
1750
|
+
},
|
|
1751
|
+
days: {
|
|
1752
|
+
type: "integer",
|
|
1753
|
+
minimum: 30,
|
|
1754
|
+
maximum: 3650,
|
|
1755
|
+
description: "Lookback window in days (default 365).",
|
|
1756
|
+
},
|
|
1757
|
+
},
|
|
1758
|
+
},
|
|
1759
|
+
},
|
|
1732
1760
|
{
|
|
1733
1761
|
name: "group_expenses",
|
|
1734
1762
|
description:
|
|
@@ -2386,6 +2414,15 @@ async function handleTool(name, args) {
|
|
|
2386
2414
|
})
|
|
2387
2415
|
);
|
|
2388
2416
|
|
|
2417
|
+
case "get_client_advance_balances":
|
|
2418
|
+
return formatResult(
|
|
2419
|
+
await client.execute("get_client_advance_balances", {
|
|
2420
|
+
clientEmail: args.clientEmail,
|
|
2421
|
+
clientName: args.clientName,
|
|
2422
|
+
days: args.days,
|
|
2423
|
+
})
|
|
2424
|
+
);
|
|
2425
|
+
|
|
2389
2426
|
case "group_expenses":
|
|
2390
2427
|
return formatResult(
|
|
2391
2428
|
await client.execute("group_expenses", {
|
|
@@ -2523,7 +2560,7 @@ function formatResult(result) {
|
|
|
2523
2560
|
|
|
2524
2561
|
async function main() {
|
|
2525
2562
|
const server = new Server(
|
|
2526
|
-
{ name: "expensebot-auth", version: "0.6.
|
|
2563
|
+
{ name: "expensebot-auth", version: "0.6.19" },
|
|
2527
2564
|
{ capabilities: { tools: {} }, instructions: SERVER_INSTRUCTIONS }
|
|
2528
2565
|
);
|
|
2529
2566
|
|
package/src/test.js
CHANGED
|
@@ -23,7 +23,7 @@ import { readStructuredHttpError } from "./client.js";
|
|
|
23
23
|
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
24
24
|
const SERVER_PATH = path.join(__dirname, "index.js");
|
|
25
25
|
|
|
26
|
-
const EXPECTED_TOOL_COUNT =
|
|
26
|
+
const EXPECTED_TOOL_COUNT = 51;
|
|
27
27
|
const REQUIRED_TOOLS = [
|
|
28
28
|
// v0.5.x
|
|
29
29
|
"search_expenses",
|
|
@@ -59,6 +59,7 @@ const REQUIRED_TOOLS = [
|
|
|
59
59
|
"get_expense_splits",
|
|
60
60
|
"get_monthly_books_review",
|
|
61
61
|
"get_credits_refunds",
|
|
62
|
+
"get_client_advance_balances",
|
|
62
63
|
];
|
|
63
64
|
|
|
64
65
|
const REQUESTS = [
|