{
  "markdown": "# mcp-office-suite\n\n<!-- mirror-seo:start -->\n\n**MCP server for small business accounting and paperwork: invoices, PDFs, spreadsheets, Word documents, time tracking and expenses.** One install that exposes every tool of all 31 servers, 292 of them.\n\nWorks with Claude Desktop, Claude Code, Cursor and any Model Context Protocol client. Runs on your own machine, or hosted with no install.\n\n## Install\n\n**Hosted, nothing to install.** Get a token from <https://mcp.zovo.one/mcp/connect> (the connect page) or <https://mcp.zovo.one/mcp/token> (the same token as JSON); a free anonymous one is issued on the spot and a Pro key works the same way. Then point an MCP client at `https://mcp.zovo.one/mcp/office-suite` over streamable-http and send the token as `Authorization: Bearer <token>`.\n\nIf your client cannot set headers, put the token in the path instead: `https://mcp.zovo.one/mcp/office-suite/t/<token>`. Both forms work. The bare URL with no token answers 401 on `tools/call`, so the token is not optional.\n\n**Claude Desktop, one click.** Download `office-suite.mcpb` from the [latest release](https://github.com/theluckystrike/mcp-servers/releases/latest) and double-click it.\n\n**From source.** The mirror is self-contained: every `@theluckystrike/*` dependency is vendored, so a fresh clone builds with no extra setup.\n\n```sh\ngit clone https://github.com/theluckystrike/mcp-office-suite.git\ncd mcp-office-suite\nnpm install && npm run build\n```\n\nThen point your client at the built entry point:\n\n```json\n{\n  \"mcpServers\": {\n    \"office-suite\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/mcp-office-suite/dist/index.js\"]\n    }\n  }\n}\n```\n\n> `@theluckystrike/mcp-office-suite` is **not published on npm yet**, so an `npx -y @theluckystrike/mcp-office-suite` command will fail. The three paths above are the working ones and each is exercised by CI.\n\n![office-suite demo](https://raw.githubusercontent.com/theluckystrike/mcp-servers/main/assets/demo-office-suite.gif)\n\nRead-only mirror of [mcp-servers/servers/office-suite](https://github.com/theluckystrike/mcp-servers/tree/main/servers/office-suite). See [MIRROR.md](MIRROR.md).\n\n<!-- mirror-seo:end -->\n\nOne install for the whole freelancer office. This MCP server proxies all 31 sibling servers in this repository, so a client gets every one of their 292 tools behind a single config entry instead of 31. The child list is published at runtime as the `office://tools_map` resource, which is the only figure to trust: it is read from the running server, not from this file. Under the hood it starts each sibling as its own stdio child process, forwards `tools/call`, `resources/*` and `prompts/*` to whichever child owns the name, and merges their license state into one `license_status` / `license_activate` pair. Nothing is re-implemented: each child server runs exactly as it does standalone, with its own local JSON storage.\n\n**Every tool of time-tracker, price-tracker, spreadsheet and invoice, one `claude mcp add`.**\n\n## 60-second install\n\nnpm publish for `@theluckystrike/mcp-office-suite` (and its dependencies) is pending. Until then, the `.mcpb` one-click bundle or a clone+build is the working path -- both are verified below. This server is packaged as `office-suite.mcpb` on release v0.2.1 and is listed on the official MCP registry (`io.github.theluckystrike/office-suite-time-invoice-expense-excel-price`).\n\n**One-click (.mcpb):** download `office-suite.mcpb` from the latest release and double-click it in Claude Desktop:\nhttps://github.com/theluckystrike/mcp-servers/releases/latest\n\n**Claude Desktop** (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"office-suite\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@theluckystrike/mcp-office-suite\"]\n    }\n  }\n}\n```\n\n**Claude Code:**\n\n```sh\nclaude mcp add office-suite -- npx -y @theluckystrike/mcp-office-suite\n```\n\n**Cursor** (`.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"office-suite\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@theluckystrike/mcp-office-suite\"]\n    }\n  }\n}\n```\n\nThe `npx` form above starts working the moment the package is published. Until then, use the .mcpb bundle above, or\nbuild from source with exactly these commands:\n\n```sh\ngit clone https://github.com/theluckystrike/mcp-servers.git && cd mcp-servers\nnpm install\nnpm run build\n```\n\n`npm run build` (no `-w`) is required here -- it builds `mcp-license` and every sibling server that office-suite spawns as a child, then office-suite itself. Then point your client's `command` at `node` with one arg: the absolute path to `servers/office-suite/dist/index.js`.\n\nTo run every server in Pro mode set `MCP_LICENSE_KEY` in the same config block, or call `license_activate` once with your key -- it is forwarded to every connected child. Activation is all-or-nothing: the reply is an error unless **every** child accepted the key, and it prints a per-child table (`OK` / `FAILED` with each child's own message) so a bundle that is half Pro cannot look like a success.\n\n## Why one server instead of thirty-one\n\nAggregation is what usage rewards in this category: the most-used server we track is a tool-aggregator gateway with 2,530 tools and 419,019 uses, 7.5x the next server and 30x the cohort median. A user who wants \"office stuff\" should not have to add thirty-one separate MCP servers to one client config. Installing this one gets every tool below.\n\n## Tools\n\nTool names are passed through unchanged from each child. If this bundle ever proxies two children that register the same tool name, both are exposed with a `<child>_<tool>` prefix instead -- the current renamed pairs are listed under Renamed tools below.\n\n### time-tracker\n\n| Tool | What it does |\n|---|---|\n| `timer_start` | Start a stopwatch for a project; stops and logs any previous running timer |\n| `timer_stop` | Stop the running timer and log it as a time entry |\n| `timer_status` | Show the running timer and today's total hours |\n| `entry_add` | Log time you already worked, with a start plus end or minutes |\n| `entry_list` | List logged time entries as a table (free: last 7 days) |\n| `entry_delete` | Delete one time entry by id |\n| `entry_edit` | Change fields of an existing entry |\n| `project_set_rate` | Set the hourly rate and currency for a project |\n| `report` | Hours and money by project, day, task or tag (tag grouping is Pro) |\n| `export_csv` | Export the timesheet to a CSV file |\n| `invoice_summary` | Turn tracked billable time into invoice line items |\n\n### price-tracker\n\n| Tool | What it does |\n|---|---|\n| `price_check` | Check a product's current price right now |\n| `watch_add` | Start watching a product URL for price drops |\n| `watch_list` | List all watched products and their latest price |\n| `watch_remove` | Stop watching a product |\n| `watch_refresh` | Re-check all watches (or one) immediately |\n| `price_history` | Price history for one watched product |\n| `price_add_manual` | Record a price by hand, for sites that block fetching |\n| `alerts_pending` | Watches that dropped below their target price |\n\n### spreadsheet\n\n| Tool | What it does |\n|---|---|\n| `sheet_info` | Overview of a CSV/XLSX file: sheets, columns, row count |\n| `sheet_read` | Read rows from a spreadsheet |\n| `sheet_query` | Filter, group and sort rows |\n| `sheet_stats` | Per-column statistics (min, max, mean, sum, distinct) |\n| `sheet_find` | Find text across a spreadsheet |\n| `sheet_write` | Write rows into a spreadsheet |\n| `sheet_add_column` | Add a computed column |\n| `sheet_convert` | Convert between CSV and XLSX |\n\n### invoice\n\n| Tool | What it does |\n|---|---|\n| `business_set` | Set your business profile: name, address, VAT id, IBAN, default currency and terms |\n| `client_add` | Store a client so invoices can refer to them by name |\n| `client_list` | List every stored client |\n| `invoice_create` | Create an invoice from line items, with tax and discount |\n| `invoice_from_hours` | Create an invoice from hours worked at a rate |\n| `invoice_list` | List invoices |\n| `invoice_get` | Get one invoice by id or number |\n| `invoice_mark_paid` | Record a payment against an invoice |\n| `invoice_pdf` | Render an invoice as a PDF file |\n| `overdue_report` | Invoices past their due date, by how many days (Pro) |\n\n### Bundle-wide\n\n| Tool | What it does |\n|---|---|\n| `license_status` | Free/Pro status of every proxied server, and the bundle upgrade link |\n| `license_activate` | Activate one Pro bundle key across every server at once. Returns an error with a per-child table unless all of them accepted it |\n\nResources and prompts registered by any child (for example time-tracker's `timetracker://today` resource and `daily_standup` prompt) are also proxied under their original names.\n\n### Renamed tools\n\nTwo children can register the same tool name -- invoice and docx both have `business_set`. The bundle then exposes both, prefixed with the server they came from (`invoice_business_set`, `docx_business_set`), names the renames once on startup, and **rewrites the child's own answer** so a response that said \"Run `business_set` ...\" says the name you can actually call. The full mapping is published as the `office://tools_map` resource: exposed name -> `child.tool`, with the renamed pairs listed separately.\n\n## Free vs Pro\n\nEach child server keeps its own free tier exactly as documented in its own README (see each `servers/<name>/README.md`). This bundle changes nothing about those limits -- it only changes how many config entries it takes to reach all of them.\n\nA single **bundle** Pro key ($39 one-time, lifetime) unlocks Pro on every server in the bundle, instead of buying each server's $19 key separately. Activate it once here and it is forwarded to every child.\n\n**Get Pro:** https://mcp.zovo.one/buy/bundle\n\n## Child processes\n\nEach child runs as its own stdio process. Two things the proxy does on their behalf:\n\n- **Their stderr is drained into ours**, one line at a time, tagged with the child it came from (`[invoice] ...`). A child's stderr is a pipe with a small OS buffer; left unread, a child that logged more than that buffer blocked in `write()` and the tool call it was answering never returned.\n- **A child that dies rejects its in-flight requests** before the suite tries to restart it, so a proxied call fails fast instead of hanging until the client's timeout, where a retry could repeat a mutation that had already been applied.\n\n## Privacy\n\nEvery child server stores its data locally, in `${XDG_DATA_HOME:-~/.local/share}/mcp-servers/<name>/` per server. This bundle adds no storage of its own and sends nothing anywhere; it only pipes stdio between your MCP client and the child processes it starts on your own machine.\n\n## expense-tracker\n\nTODO: `servers/expense-tracker/dist` does not exist yet in this repository. Once that server is built and shipped, add it to `CHILDREN` in `src/index.ts`, its dependency to `package.json`, its build step to the Dockerfile, and its tool table to this README.\n\n---\n\nBuilt by theluckystrike (https://github.com/theluckystrike).\n",
  "bytes": 11047,
  "sha": "14099689a4479208cdafe153de2632f05b67ac25e2cbf339cd988f12518c80d2",
  "repo_slug": "theluckystrike/mcp-office-suite",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_bestremotetools_office_suite_all_ser_c0d2b4b3/readme"
}