Back to search
usual-mcp
MCP serverGitHub
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
Markdown
[](/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
- # Usual MCP server
- 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.
- > "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_…` |
- 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**
- ```sh
- 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
- ```json
- {
- "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](https://www.npmjs.com/package/mcp-remote):
- ```json
- {
- "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](https://api.usual.so/v1/openapi.json). 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](https://app.usual.so/sign-up?utm_source=github&utm_campaign=mcp).
- The checklists themselves are open: [Usual-so/client-document-checklists](https://github.com/Usual-so/client-document-checklists).
- Questions: support@usual.so
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.