Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the Tidely in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
Summary
Tidely cash flow planning: the cash flow and forecast per month, week or day, scenarios, categories, bank accounts with balances and transactions, sales and purchase invoices, and planned values. Reads plus creating and updating invoices, plans, categories and transactions; deletes are installed switched off.
Try asking
Example prompts for Tidely
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Tidely, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Tidely + ChatGPT
Tidely cash flow planning: the cash flow and forecast per month, week or day, scenarios, categories, bank accounts with balances and transactions, sales and purchase invoices, and planned values. Reads plus creating and updating invoices, plans, categories and transactions; deletes are installed switched off.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
TIDELY_API_KEY
Step 1 — Get credentials
Setting up takes about 5 minutes. You need a Tidely account with API access enabled; the only credential is an API key.
API access comes first: the API must be enabled for your Tidely account. If Settings → API Keys is missing, ask Tidely support ([email protected]) to enable it.
- Sign in to Tidely and open Settings → API Keys (app.tidely.com/settings/openapi). Click + to create a key and give it the scopes you need: read for the read tools, and write if the AI should create or update invoices, plans, categories or transactions.
- Copy the key, store it securely and paste it into
TIDELY_API_KEY. Paste only the key, withoutBeareror any other prefix: the connector sends it in theX-Authorizationheader. - Install the connector. Run
tidely_verify_authto check the connection: it returns the name of the user the key belongs to.
Cloud and self-hosted work the same way: the API key is the only credential, and there is no redirect URL to set.
Where to start: tidely_get_cashflow answers most liquidity questions: the balance now and the forecast per month, week or day. Without parameters it uses the base scenario, monthly periods, 6 months back and 18 ahead. For monthly periods from is the first day of a month and to the last day of a month (for weeks, a Monday and a Sunday). tidely_list_scenarios gives the ids of the other scenarios.
Invoices need their type: tidely_list_invoices, tidely_get_invoice and tidely_update_invoice take invoiceTypeFilter SALE or PURCHASE, which must match the invoice. Invoices synced from an ERP integration are read-only.
Transactions and imports: transactions are listed per bank account (bankAccountId). New transactions can only be added to bank accounts kept in Tidely (provider API or OFFLINE). Before importing from another system, tidely_check_transactions_exist checks up to 1000 external ids, so nothing is added twice.
Plans add up: tidely_create_plan adds a one-time amount to the planned values of a category in a scenario (the base case by default) for a day, week or month; with replaceCurrentValuesForThePeriod it replaces them instead. The category must accept planned values; without a category the amount goes to uncategorized income or expenses.
What it reads: the cash flow per month, week or day for a scenario, with opening and closing balances (actual, forecast and plan), open sales and purchase invoices, amounts per category, KPIs, overdraft and liquidity; planning scenarios; the category tree with its income and expense types; companies with currency and country; bank accounts with IBAN, type, provider and reference balance, their daily balance history and their transactions with counterpart, purpose and category; sales and purchase invoices with contact, dates, gross and open amount, status, category and source.
Switched off at install: tidely_delete_invoice, tidely_delete_category, tidely_delete_plans and tidely_delete_bank_account_transaction. They delete an invoice, a category, all planned values of one category in one scenario, or a bank account transaction, and none of it can be undone. Switch on only the ones you need on the connector page; the AI asks you to confirm every change first. Creating and updating invoices, categories, plans and bank account transactions is switched on (tidely_create_invoice, tidely_update_invoice, tidely_create_category, tidely_update_category, tidely_create_plan, tidely_create_bank_account_transaction, tidely_update_bank_account_transaction); these calls need a key with the write scope.
Nothing moves money: transactions and invoices are records for planning; no tool pays or transfers anything. Bulk imports, creating or changing bank accounts and the Partner API (OAuth, for white-label partners) are not part of this connector.
Amounts, dates and paging: amounts are decimals in the account or company currency, negative for outgoing money and expenses; dates are YYYY-MM-DD. Paged lists start at page 0, return 50 items per page by default and report totalPages.
Common errors: 401 (INVALID_CREDENTIALS) means the key is missing or wrong: create a new one and paste it without a prefix. 403 (INSUFFICIENT_SCOPE) means the key is valid but lacks the scope for that call: edit its scopes under Settings → API Keys. 400 (INVALID_REQUEST) is invalid input and 404 an unknown id, for example CATEGORY_NOT_FOUND. A 500 is worth one retry after a short wait.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in ChatGPT
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
ChatGPT adds MCP servers as plugins on its Plugins page, on the web and on paid plans. Developer mode is no longer needed. In a Business workspace only admins and owners can add one; in Enterprise and Edu an admin can grant the Create plugins with MCPs permission.
- Go to chatgpt.com/plugins, click Add, then Add custom MCP server.
- Enter a name, e.g. Name:
Tidely. - Under Connection, enter the Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDand keep Authentication on OAuth. - Select I understand and want to continue, then Create as a plugin. When ChatGPT asks, sign in to AnythingMCP and allow access.
- Install the new plugin from your personal plugins, then type @ in a chat and pick it.
Available tools
| Tool | What it does |
|---|---|
tidely_verify_auth | Check that the API key is valid; returns success and the name of the user the key belongs to |
tidely_list_companies | List the companies of the Tidely account (paged): id, parentId, name, currency, country and industry |
tidely_get_company | Get one company of the Tidely account by id: name, parent company, currency, country and industry |
tidely_get_cashflow | Get the cash flow of the company per period (month, week or day) for a scenario: for each period start date the opening and closing… |
tidely_list_scenarios | List the planning scenarios: id, name and isBaseCase |
tidely_get_scenario | Get one planning scenario by id: id, name and whether it is the base case |
tidely_list_categories | List the cash flow categories: id, name, type (INCOME_/EXPENSE_ OPERATIONAL, INVESTMENT or FINANCING), parentId for the hierarchy and… |
tidely_get_category | Get one category by id: name, type, parent and whether it accepts planned values |
tidely_list_bank_accounts | List the bank accounts in Tidely: id, companyId, account name, bank, IBAN or account number, currency, type (CHECKING, SAVINGS, CREDITCARD… |
tidely_get_bank_account | Get one bank account by id: name, bank, IBAN, currency, type, provider, reference balance and visibility |
tidely_list_bank_account_balances | List the balance history of one bank account (paged): date and amount per day |
tidely_list_bank_account_transactions | List the transactions of one bank account (paged): id, booking date, amount, counterpart name, IBAN and reference, purpose, category and… |
tidely_get_bank_account_transaction | Get one bank account transaction by id: booking date, amount, counterpart, purpose, category and external id |
tidely_check_transactions_exist | Check which of up to 1000 external ids already exist as transactions on a bank account, before importing transactions from another system |
tidely_list_invoices | List sales or purchase invoices (paged): id, number, contact, dates, gross and open amount, status, category, type, source (ERP sync… |
tidely_get_invoice | Get one invoice by id; invoiceTypeFilter must match its type |
tidely_create_invoice | Create a sales or purchase invoice (or credit note) so it shows up in the cash flow forecast on its due date |
tidely_update_invoice | Update an invoice: only the fields you pass change (status, paid date, open amount, due date, amounts, category, note ...) |
tidely_delete_invoice | Delete an invoice (not those synced from an ERP integration) |
tidely_create_category | Create a cash flow category, optionally under a parent category |
tidely_update_category | Rename a cash flow category or change its type (income or expense, operational, investment or financing) |
tidely_delete_category | Delete a cash flow category by id |
tidely_create_plan | Add a planned value to the forecast: a one-time amount on a category in a scenario for a day, week or month (negative for expenses… |
tidely_delete_plans | Delete all planned values of one category in one scenario |
tidely_create_bank_account_transaction | Add a transaction to a bank account kept in Tidely (an API or offline account), e.g. imported from another system |
tidely_update_bank_account_transaction | Update a bank account transaction: only the fields you pass change, typically its category |
tidely_delete_bank_account_transaction | Delete a bank account transaction |
Example prompts
- "What is our cash balance today, and what does the forecast show for the next six months?"
- "Which sales invoices are still open, and which of them are past their due date?"
- "Compare the closing balance of the base case with our other scenarios, month by month."
- "Mark purchase invoice 2026-118 as paid today."
- "Add a planned expense of 12,000 for new hardware in March 2027 to the IT category in the base case."
FAQ
Does the free ChatGPT plan work with custom MCP servers? OpenAI documents custom MCP servers for paid plans only; the Free plan is not on its list.
Next steps
Was this guide helpful?