Plugin access to boards and tasks
A plugin you approve can read and change the Mission Control boards and task lists you pick, never more than you could do yourself. Deleting a task, assigning a person and commenting on a board always ask you first, and you can see and take back everything in Settings → Plugins. It is off until you turn on Plugin access to boards and tasks in Settings → Labs.
On this page
What it is
A plugin can ask for four permissions, shown on its install card:
| Permission | What it lets the plugin do |
|---|---|
Boards (boards.read) |
Read the items, columns and status on the boards you share. |
Change boards (boards.write) |
Add, move and update items and post comments on the boards you share. |
Tasks (tasks.read) |
Read the task lists you share, with their tasks, due dates and status. |
Change tasks (tasks.write) |
Add, edit, complete, reorder, move, archive and restore tasks in the lists you share. |
A plugin that asks to change something must also ask to read it, so the card always shows everything it holds. The two change permissions are marked as elevated.
Two sibling areas work the same way: a plugin can manage the sessions you pick (see Plugin control of
your sessions) and read and change notes in the Vault folders you pick (see Plugin access to your
Vault, vault.read and vault.write, with its own Labs switch).
Where to find it
- The switch: Settings → Labs → Plugin access to boards and tasks.
- Sharing: when a plugin needs your tasks, a picker opens. Tick single lists, or All lists, including new ones, which covers every list you have now or make later. Boards are picked one at a time.
- Review and revoke: Settings → Plugins → the plugin's card lists every board and task-list grant with a Revoke button, and the changes the plugin made. This panel is on the desktop app only.
How it behaves
- Nothing is shared until you pick it. A plugin asking about a board or list you did not share gets the same "not found" answer as for one that does not exist.
- Grants belong to the person who made them. If someone else signs in on the same computer, your grants do not cover their lists.
- Deleting a task, putting a person in a people column, and posting a board comment show a question written by Omniscio from its own records: which plugin, what will happen, and to which item or task. Saying no, closing the dialog, or not answering means nothing changes. Everything else runs without asking, because it reaches no one else and can be undone.
- Board roles, view-only boards, locked columns and columns hidden from you all still apply to the plugin.
- A plugin never spends Omniscio's money or sees passwords, keys or tokens, and its panel cannot read your boards or tasks; only its background program can, through Omniscio.
- A plugin can make at most 60 reads and 10 changes a minute.
- Revoking, turning the plugin off or uninstalling it stops its very next call, with no restart.
Speed cost
Not measured yet. The feature adds no background work of its own (no timer, poller or watcher); it only does work when a plugin calls it, and each call is capped at 60 reads and 10 changes a minute. The off-and-on measurement in the shared Speed Cost Format needs a plugin that actually uses these permissions, and is owed before the feature goes to dogfood.
Related
Plugin control of your sessions explains the sibling permission for managing the sessions you pick, Plugin access to your Vault explains the sibling permissions for the notes in the Vault folders you pick, the Documents Permission page explains the sibling permission for your own writing, the Plugin Marketplace page covers installing plugins and the consent card, and Plugin Developer Mode explains how a self-built plugin can use these permissions before the marketplace lists them.
Last verified 2026-11-09