Repository avatar
Other Tools
v1.0.0
active

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.

URLhttps://api.usual.so/mcp
TransportStreamable HTTP
AuthAuthorization: Bearer usl_…
  1. In Usual, open Settings › Developers. Under API tokens, name it (for example "Claude") and press Create token. Copy it; it isn't shown again.
  2. 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

ToolWhat it does
whoamiThe firm the token belongs to
list_clientsClients with their id and email; search narrows by name or email
add_clientAdds a person or business with the contact who gets requests
list_checklistsYour checklists and Usual's built-in library (monthly close, tax organizers, onboarding, 1099s, every state); search narrows by name
list_requestsRequests with how many required items are in and how many wait for review (active, completed or archived)
get_requestOne request, item by item: todo, submitted, approved or sent back
send_requestCreates 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 send is true, 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.

Remote