AI platforms (MCP)

Let Claude or another AI platform read your documents and time off, start drafts and send reminders, through our MCP server on your own computer.

Your own AI platform is separate from AI Assist, which is built into the app. Our MCP server lets an AI platform that speaks the Model Context Protocol, such as Claude Desktop or Claude Code, work with your account. It runs on your own computer and uses the API as you, with a personal token you make for it.

What it can and can't do

The AI platform can:

  • read your Inbox, what waits for your approval, your documents and templates, the people in a workspace and your time off;
  • report how many documents are in each state and which have waited longest, and who is away between two dates;
  • start a draft from a template;
  • send a reminder on a document that is waiting on someone.

It never signs, approves, declines, sends, voids or books anything. A draft it starts waits for you to check and send it in the app. The token itself can't hold those permissions, and the API refuses them to it anyway. Everything it does is recorded in the audit trail as done through AI.

What it sees is what the API returns: titles, references, names, states and dates. It is never given a document's contents.

Make a token for it

  1. Open Settings › Devices and tokens in the app.
  2. Under Personal tokens, give it a name, such as Claude, and tick For an AI platform.
  3. Tick what it may do. Only what an AI platform may hold is offered.
  4. Choose when it expires and make it. Copy the token now: it is shown only once.

Revoke it on the same page whenever you like; the AI platform stops at once.

Set it up

The server needs Node.js 22 or later. Give it the token in MCP_API_TOKEN. MCP_API_URL is the API's address; leave it out to use ours.

In Claude Desktop, add it to claude_desktop_config.json:

{
  "mcpServers": {
    "documents": {
      "command": "node",
      "args": ["/path/to/apps/mcp/src/stdio.ts"],
      "env": { "MCP_API_TOKEN": "s2a_pat_…" }
    }
  }
}

In Claude Code:

claude mcp add documents --env MCP_API_TOKEN=s2a_pat_… -- node /path/to/apps/mcp/src/stdio.ts

Keep the token out of shared files and screenshots: it acts as you.

Its tools

ToolWhat it does
list_workspacesWho you are and your workspaces
inboxWhat waits for you, or for your team
approvals_waitingWhat waits for your decision (read only)
list_envelopes, get_envelopeFind documents, and one document's recipients and steps
list_templates, get_templateTemplates you may start from
find_peoplePeople in a workspace
time_offYour allowance and requests
report_documentsDocuments by state, and those waiting longest
report_time_offWho is away between two dates
start_from_templateStart a draft from a template; nothing is sent
send_reminderRemind whoever a document waits on

A server you connect to over the web, signed in with your account instead of a token, comes later with version 1 of the API.

On this page