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
- Open Settings › Devices and tokens in the app.
- Under Personal tokens, give it a name, such as Claude, and tick For an AI platform.
- Tick what it may do. Only what an AI platform may hold is offered.
- 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.tsKeep the token out of shared files and screenshots: it acts as you.
Its tools
| Tool | What it does |
|---|---|
list_workspaces | Who you are and your workspaces |
inbox | What waits for you, or for your team |
approvals_waiting | What waits for your decision (read only) |
list_envelopes, get_envelope | Find documents, and one document's recipients and steps |
list_templates, get_template | Templates you may start from |
find_people | People in a workspace |
time_off | Your allowance and requests |
report_documents | Documents by state, and those waiting longest |
report_time_off | Who is away between two dates |
start_from_template | Start a draft from a template; nothing is sent |
send_reminder | Remind 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.