
usual
so.usual/usual
Collect documents from clients: send checklists that chase on their own, see what's missing.
Documentation
Usual MCP server
Connect Claude, Cursor or any MCP client to Usual, the free client document collection tool for bookkeeping, tax and CPA firms. Your assistant can look up clients and checklists, send a request, and tell you exactly what a client still owes.
"Send Northside Plumbing the monthly close, due the 10th." "What is Dee still missing for October?" "Which requests have files waiting for my review?"
Once a request is sent, Usual does the rest: the client gets a link that opens on any phone with no login, can reply to the email with files attached, and gets reminders on your schedule until everything is in.
Connect
It's a remote server. Nothing to install.
| URL | https://api.usual.so/mcp |
| Transport | Streamable HTTP |
| Auth | Authorization: Bearer usl_… |
- In Usual, open Settings › Developers. Under API tokens, name it (for example "Claude") and press Create token. Copy it; it isn't shown again.
- Add the server to your client.
Claude Code
claude mcp add --transport http usual https://api.usual.so/mcp --header "Authorization: Bearer usl_YOUR_TOKEN"
Cursor (~/.cursor/mcp.json) and other clients that take a URL and headers
{
"mcpServers": {
"usual": {
"url": "https://api.usual.so/mcp",
"headers": { "Authorization": "Bearer usl_YOUR_TOKEN" }
}
}
}
Clients that only run local servers (Claude Desktop config, for example), through mcp-remote:
{
"mcpServers": {
"usual": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.usual.so/mcp", "--header", "Authorization: Bearer usl_YOUR_TOKEN"]
}
}
}
Tools
| Tool | What it does |
|---|---|
whoami | The firm the token belongs to |
list_clients | Clients with their id and email; search narrows by name or email |
add_client | Adds a person or business with the contact who gets requests |
list_checklists | Your checklists and Usual's built-in library (monthly close, tax organizers, onboarding, 1099s, every state); search narrows by name |
list_requests | Requests with how many required items are in and how many wait for review (active, completed or archived) |
get_request | One request, item by item: todo, submitted, approved or sent back |
send_request | Creates a request from a checklist with a due date. send: true emails the client now; send: false keeps a draft to check in Usual |
Safety
- The token acts with its creator's access, through Usual's public API. Revoke it in Settings › Developers and anything using it stops at once.
- The tools return names, statuses and dates. Client files, answers and tax IDs never go to the assistant.
- Nothing is sent to a client unless
sendistrue, and the server tells assistants to send only when you asked. - No tool deletes anything.
Free
Usual is free for 10 active clients with unlimited requests, the API and this server included. Start free.
The checklists themselves are open: Usual-so/client-document-checklists.
Questions: support@usual.so
No installation packages available.