# HeyBMO developer docs > HeyBMO is a personal organiser made of features you switch on (notes, lists, reminders, expenses, debts, automations). Every feature is available through one HTTP API, an MCP server for AI apps and the `heybmo` command line tool. ## Calling an operation POST https://app.heybmo.com/api/ops/ with JSON {"input": {...}} and Authorization: Bearer . The answer is {"output": {...}}. GET https://app.heybmo.com/api/ops/catalog lists every operation with JSON Schemas. AI apps connect to the MCP server at https://app.heybmo.com/mcp. The CLI installs with `npm install -g heybmo`. ## Docs - [Overview](https://docs.heybmo.com/): Build with HeyBMO: the REST API, the MCP server for AI apps and the CLI, over every feature. - [Authentication](https://docs.heybmo.com/authentication): API keys and sign-in for the HeyBMO API, AI apps and the CLI. - [Errors and limits](https://docs.heybmo.com/errors): HeyBMO API error codes, the error body, rate limits and confirmed deletes. - [REST API](https://docs.heybmo.com/api): Call any HeyBMO operation with one POST request: inputs, outputs, discovery and OpenAPI. - [MCP server](https://docs.heybmo.com/mcp): Connect Claude, ChatGPT, Claude Code and other MCP apps to HeyBMO: the server address, signing in, how the tools work and every tool it offers. - [CLI](https://docs.heybmo.com/cli): The heybmo command line tool: install, sign in, commands, flags and exit codes. - [Full reference as one Markdown file](https://docs.heybmo.com/llms-full.txt) - [OpenAPI](https://docs.heybmo.com/openapi.json) ## Operations ### Account (https://docs.heybmo.com/api/account) - account.spaces (read): List your spaces - account.timeZone (read): Get your time zone - account.changeTimeZone (write): Change your time zone - account.currency (read): Get your home currency - account.changeCurrency (write): Change your home currency - account.profile (read): Get your profile - account.changeProfile (write): Change your profile ### Inbox (https://docs.heybmo.com/api/inbox) - inbox.list (read): Read the inbox - inbox.markRead (write): Mark inbox entries read - inbox.settings (read): Read notification settings - inbox.changeSettings (write): Change notification settings - inbox.devices (read): List devices that show pop-ups - inbox.addDevice (write): Allow pop-ups on this browser - inbox.removeDevice (delete): Stop pop-ups on a device - inbox.testPopup (write): Send a test pop-up ### Today (https://docs.heybmo.com/api/home) - home.layout (read): Read the Today page layout - home.saveLayout (write): Arrange the Today page ### Feature store (https://docs.heybmo.com/api/marketplace) - marketplace.list (read): List features you can switch on - marketplace.get (read): Read a feature’s store page - marketplace.enable (write): Switch a feature on - marketplace.disable (write): Switch a feature off ### Notes (https://docs.heybmo.com/api/notes) - notes.create (write): Create a note - notes.get (read): Read a note - notes.list (read): List notes - notes.search (read): Search notes - notes.update (write): Change a note - notes.append (write): Add text to a note - notes.replaceText (write): Replace text in a note - notes.delete (delete): Move a note to the trash - notes.restore (write): Restore a note from the trash - notes.trash (read): List notes in the trash - notes.deleteForever (delete): Delete notes in the trash for good - notes.attach (write): Attach a file to a note - notes.finishAttach (write): Finish attaching a file - notes.detach (delete): Delete an attachment - notes.folders (read): List note folders - notes.createFolder (write): Create a folder - notes.updateFolder (write): Rename or move a folder - notes.deleteFolder (delete): Delete a folder - notes.tags (read): List tags - notes.renameTag (write): Rename a tag everywhere - notes.removeTag (delete): Remove a tag everywhere ### Lists (https://docs.heybmo.com/api/lists) - lists.create (write): Create a list - lists.get (read): Read a list’s columns - lists.list (read): List all lists - lists.update (write): Change a list - lists.addField (write): Add a column to a list - lists.updateField (write): Change a column - lists.removeField (delete): Remove a column - lists.items (read): Read a list’s items - lists.addItems (write): Add items to a list - lists.updateItems (write): Change items - lists.tick (write): Tick or untick items - lists.tickMatching (write): Tick every matching item - lists.moveItems (write): Move items - lists.moveMatching (write): Move every matching item to another list - lists.reset (write): Untick a whole list - lists.due (read): Items due across lists - lists.search (read): Search lists and items - lists.delete (delete): Move a list to the trash - lists.restore (write): Restore a list from the trash - lists.trash (read): List the trash - lists.deleteItems (delete): Move items to the trash - lists.deleteMatching (delete): Move every matching item to the trash - lists.restoreItems (write): Restore items from the trash - lists.clearTicked (delete): Clear ticked items - lists.deleteForever (delete): Delete lists in the trash for good ### Expenses (https://docs.heybmo.com/api/expenses) - expenses.add (write): Log spending or income - expenses.update (write): Change entries - expenses.moveToCategory (write): Move matching entries to a category - expenses.entries (read): List or search entries - expenses.totals (read): Add up spending and income - expenses.categories (read): List categories - expenses.addCategory (write): Add a category - expenses.updateCategory (write): Rename or archive a category - expenses.budgets (read): See budgets - expenses.setBudget (write): Set a monthly budget - expenses.removeBudget (delete): Remove a budget - expenses.delete (delete): Move entries to the trash - expenses.restore (write): Restore entries from the trash - expenses.trash (read): List the trash - expenses.deleteForever (delete): Delete entries in the trash for good - expenses.attachReceipt (write): Attach a receipt - expenses.finishReceipt (write): Finish attaching a receipt - expenses.readReceipt (read): Read a receipt - expenses.removeReceipt (delete): Delete a receipt - expenses.recurring (read): List recurring bills and income - expenses.addRecurring (write): Add a recurring bill or income - expenses.updateRecurring (write): Change a recurring bill or income - expenses.removeRecurring (delete): Remove a recurring bill or income ### Debts (https://docs.heybmo.com/api/debts) - debts.add (write): Record money lent or borrowed - debts.update (write): Change debts - debts.list (read): List or search debts - debts.balances (read): Who owes what - debts.balanceHistory (read): Who owed what on past days - debts.history (read): What happened with a person - debts.payBack (write): Record a payback - debts.removePayback (delete): Remove a payback - debts.forgive (write): Forgive debts - debts.people (read): List people - debts.addPerson (write): Add a person - debts.updatePerson (write): Rename or archive a person - debts.mergePeople (write): Merge two names for one person - debts.delete (delete): Move debts to the trash - debts.restore (write): Restore debts from the trash - debts.trash (read): List the trash - debts.deleteForever (delete): Delete debts in the trash for good - debts.deletePerson (delete): Delete a person for good ### Reminders (https://docs.heybmo.com/api/reminders) - reminders.add (write): Set reminders - reminders.update (write): Change reminders - reminders.list (read): List or search reminders - reminders.agenda (read): What is coming up, day by day - reminders.counts (read): How many reminders of each sort - reminders.missed (read): What did I miss - reminders.history (read): Reminders marked done - reminders.done (write): Mark reminders done - reminders.snooze (write): Snooze a reminder - reminders.bulk (write): Act on every reminder that matches - reminders.delete (delete): Move reminders to the trash - reminders.restore (write): Restore reminders from the trash - reminders.trash (read): List the trash - reminders.deleteForever (delete): Delete reminders in the trash for good ### Automations (https://docs.heybmo.com/api/automations) - automations.events (read): List what automations can watch - automations.create (write): Create an automation - automations.list (read): List automations - automations.update (write): Change an automation - automations.delete (delete): Delete an automation - automations.runs (read): What an automation did ## Optional - [HeyBMO website](https://heybmo.com/): what HeyBMO is, for people - [HeyBMO for AI assistants](https://heybmo.com/llms.txt)