# hedwigai

> The hedwigai MCP server for clients that run servers as local commands: workbooks (spreadsheets and documents) an assistant keeps, versioned and checked against a schema.

Latest version **1.0.1** (published 2026-11-19) · MIT license · 0 weekly downloads

## Install

```sh
npm install hedwigai
pnpm add hedwigai
yarn add hedwigai
bun add hedwigai
```

Provides the command `hedwigai`.

## Health

**Score 60/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 1.0.1 |
| Published | 2026-11-19 |
| First published | 2023-10-12 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | >=18 |
| Dependencies | 1 |
| Unpacked size | 9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | hedwigai Inc. |
| Maintainers | shkr |
| Keywords | mcp, mcp-server, model-context-protocol, hedwigai, workbook, spreadsheet, xlsx, docx, claude, cursor, codex |

## Links

- npm: https://www.npmjs.com/package/hedwigai
- Homepage: https://www.hedwigai.com
- Issues: https://www.hedwigai.com/contact
- npm.io page: https://npm.io/package/hedwigai

## Dependencies (1)

- [mcp-remote](https://npm.io/package/mcp-remote.md) 0.16.6

## Alternatives

- [csv-to-markdown-table](https://npm.io/package/csv-to-markdown-table.md) — 47.0K weekly downloads
- [@sapphire/ratelimits](https://npm.io/package/@sapphire/ratelimits.md) — 4.4K weekly downloads
- [js-csvparser](https://npm.io/package/js-csvparser.md) — 2.0K weekly downloads
- [@adadapted/js-sdk](https://npm.io/package/@adadapted/js-sdk.md) — 251 weekly downloads
- [@grapecity/spread-sheets-sparklines](https://npm.io/package/@grapecity/spread-sheets-sparklines.md) — 103 weekly downloads

## Recent versions

- 1.0.1 (latest) — 2026-11-19
- 0.1.286 — 2026-06-19
- 0.1.284 — 2026-06-19
- 0.1.283 — 2026-06-19
- 0.1.282 — 2026-06-19
- 0.1.281 — 2024-12-08
- 0.1.280 — 2024-12-08
- 0.1.279 — 2024-12-08
- 0.1.278 — 2024-12-06
- 0.1.277 — 2024-12-05
- 0.1.276 — 2024-11-21
- 0.1.275 — 2024-11-14
- 0.1.274 — 2024-11-14
- 0.1.273 — 2024-11-13
- 0.1.272 — 2024-11-11
- … 242 more at https://npm.io/package/hedwigai/versions

## README

<p align="center">
  <img src="https://www.hedwigai.com/logo-512.png" alt="hedwigai" width="160" />
</p>

# hedwigai

The [hedwigai](https://www.hedwigai.com) MCP server, as a command an MCP client can start.

hedwigai is a system of record for the spreadsheets and documents an assistant keeps: a decision log, a tracker, a budget, a diligence memo, an Excel model. Each one is a **workbook**. Every write is a new version, the version before it can be restored, and every edit is checked against the workbook's schema before it is kept.

## Do you need this package?

The server is remote: `https://mcp.hedwigai.com` (streamable HTTP, OAuth sign-in). A client that takes a URL should be given that URL and does not need this package.

Use this package when your client can only start servers as local commands. It runs on your machine, speaks stdio to the client, and passes every request to the remote server.

## Use it

Add this to your client's MCP configuration:

```json
{
  "mcpServers": {
    "hedwigai": {
      "command": "npx",
      "args": ["-y", "hedwigai"]
    }
  }
}
```

The first time the client starts the server, your browser opens to sign in to your hedwigai account. Later starts reuse that sign-in.

It needs Node.js 18 or newer.

### Clients that take a URL

| Client | How to add the server |
|---|---|
| Claude Code | `claude mcp add --transport http --scope user hedwigai https://mcp.hedwigai.com`, then `/mcp`, hedwigai, Authenticate |
| Codex | `codex mcp add hedwigai --url https://mcp.hedwigai.com && codex mcp login hedwigai` |
| Claude | Settings, Connectors, Add custom connector, `https://mcp.hedwigai.com` |

## What the server offers

| Tool | What it does |
|---|---|
| `find_workbooks` | Find workbooks by title, text or meaning |
| `read_workbook` | Read a workbook, one tab, a table, a section, its schema or an earlier version |
| `create_workbook` | Start a new workbook, from text, sheets, a file or a research run |
| `write_workbook` | Save a new version, restore an earlier one, or change the schema |
| `run_workbook` | Change a workbook with a research run, answer its question, or stop its run |
| `workbook_runs` | A workbook's runs and what each one did |
| `configure_workbook` | See or change a workbook's settings and schedule |
| `link_workbook` | Link a workbook to a file in Google Drive or Dropbox |
| `mirror_workbook` | Mirror a workbook into another account |
| `share_workbook` | Email a workbook, or show, create or rotate its share link |
| `attachments` | List, add or remove the files attached to a workbook |
| `upload` | Upload a file too large to send inline |
| `folders` | List or find workbook folders |
| `edit_folders` | Create, rename or delete folders |
| `delete_workbook` | Delete a workbook, keeping its versions |
| `restore_workbook` | Bring back a deleted workbook |
| `checkout_workbook` | Put a workbook into the shell to edit, and save it back as a version |
| `bash` | Run a command in the account's shell, where its data programs live |
| `ask` | Ask a short yes or no question |
| `render_document` | Render a document to PDF |
| `credits` | Check the account's credit balance |

The server's own list is the one to trust if this table and the server disagree. Read it at `https://mcp.hedwigai.com/llms.txt`.

Reading, searching and writing workbooks directly is free. Research runs are billed to the account's prepaid credit.

## Options

| Setting | Effect |
|---|---|
| `--help` | Print usage |
| `--version` | Print the package version |
| `HEDWIGAI_MCP_URL` | Bridge to another server address. Must be `https`, or `localhost` |

Any other argument is passed to [mcp-remote](https://www.npmjs.com/package/mcp-remote), which does the bridging and the sign-in. This package pins one exact version of it.

## Version 1 replaces the old SDK

Versions 0.1.x of this package were a TypeScript SDK and the `hai` command. Version 1 contains neither. If you still depend on them, pin `hedwigai@0.1.286`.

## Support

[hedwigai.com/contact](https://www.hedwigai.com/contact)

## License

MIT

---
_Source: https://npm.io/package/hedwigai · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
