npm.io
1.0.1 • Published 20h agoCLI

hedwigai

Licence
MIT
Version
1.0.1
Deps
1
Size
9 kB
Vulns
0
Weekly
0

hedwigai

hedwigai

The hedwigai 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:

{
  "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, 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

License

MIT

Keywords