Skip to content
Back to search

usual-mcp

MCP server for Usual: let Claude, Cursor or any MCP client look up clients, send document checklists and see what a client still owes. Remote, Streamable HTTP.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/usual-so--usual-mcp/badge.svg)](/listings/usual-so--usual-mcp)

HTML

<a href="/listings/usual-so--usual-mcp"><img src="/api/listings/usual-so--usual-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 81 lines
  1. # Usual MCP server
  2. Connect Claude, Cursor or any MCP client to [Usual](https://usual.so/?utm_source=github&utm_campaign=mcp), 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.
  3. > "Send Northside Plumbing the monthly close, due the 10th."
  4. > "What is Dee still missing for October?"
  5. > "Which requests have files waiting for my review?"
  6. 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.
  7. ## Connect
  8. It's a remote server. Nothing to install.
  9. | | |
  10. |---|---|
  11. | URL | `https://api.usual.so/mcp` |
  12. | Transport | Streamable HTTP |
  13. | Auth | `Authorization: Bearer usl_…` |
  14. 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.
  15. 2. Add the server to your client.
  16. **Claude Code**
  17. ```sh
  18. claude mcp add --transport http usual https://api.usual.so/mcp --header "Authorization: Bearer usl_YOUR_TOKEN"
  19. ```
  20. **Cursor** (`~/.cursor/mcp.json`) and other clients that take a URL and headers
  21. ```json
  22. {
  23. "mcpServers": {
  24. "usual": {
  25. "url": "https://api.usual.so/mcp",
  26. "headers": { "Authorization": "Bearer usl_YOUR_TOKEN" }
  27. }
  28. }
  29. }
  30. ```
  31. **Clients that only run local servers** (Claude Desktop config, for example), through [mcp-remote](https://www.npmjs.com/package/mcp-remote):
  32. ```json
  33. {
  34. "mcpServers": {
  35. "usual": {
  36. "command": "npx",
  37. "args": ["-y", "mcp-remote", "https://api.usual.so/mcp", "--header", "Authorization: Bearer usl_YOUR_TOKEN"]
  38. }
  39. }
  40. }
  41. ```
  42. ## Tools
  43. | Tool | What it does |
  44. |---|---|
  45. | `whoami` | The firm the token belongs to |
  46. | `list_clients` | Clients with their id and email; `search` narrows by name or email |
  47. | `add_client` | Adds a person or business with the contact who gets requests |
  48. | `list_checklists` | Your checklists and Usual's built-in library (monthly close, tax organizers, onboarding, 1099s, every state); `search` narrows by name |
  49. | `list_requests` | Requests with how many required items are in and how many wait for review (`active`, `completed` or `archived`) |
  50. | `get_request` | One request, item by item: todo, submitted, approved or sent back |
  51. | `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 |
  52. ## Safety
  53. - The token acts with its creator's access, through Usual's [public API](https://api.usual.so/v1/openapi.json). Revoke it in **Settings › Developers** and anything using it stops at once.
  54. - The tools return names, statuses and dates. Client files, answers and tax IDs never go to the assistant.
  55. - Nothing is sent to a client unless `send` is `true`, and the server tells assistants to send only when you asked.
  56. - No tool deletes anything.
  57. ## Free
  58. Usual is free for 10 active clients with unlimited requests, the API and this server included. [Start free](https://app.usual.so/sign-up?utm_source=github&utm_campaign=mcp).
  59. The checklists themselves are open: [Usual-so/client-document-checklists](https://github.com/Usual-so/client-document-checklists).
  60. Questions: support@usual.so

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.