Milanote MCP Server and API by Cotlet is an MCP server published by dev.cotlet, hosted at cotlet.dev. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 69 tools, including cotlet_whoami, cotlet_apps, cotlet_request_apps, cotlet_get_call, cotlet_upload_file.
Milanote visual planning for creatives MCP server: list boards, add note, add link, upload image.
1,987 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
The Cotlet account this connection acts as: email, workspace, access status, the API key or OAuth client in use with its scope, the apps the workspace may call, its credit balance, and the app the user signed up for with its first task and sign-in link. Free. Needs the user's Cotlet API key or sign-in.
No parameters.
{
"name": "cotlet_whoami",
"title": "Cotlet: who am I",
"description": "The Cotlet account this connection acts as: email, workspace, access status, the API key or OAuth client in use with its scope, the apps the workspace may call, its credit balance, and the app the user signed up for with its first task and sign-in link. Free. Needs the user's Cotlet API key or sign-in.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: who am I",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}The apps of the user's workspace and whether each works now: the app account in the user's Cloud Browser (connected, signed out, signed in but not connected), and the one step the user has to take, with the console link. Free. Needs the user's Cotlet API key or sign-in.
| Parameter | Type | Description |
|---|---|---|
| app | string | Only this app, e.g. skool. |
{
"name": "cotlet_apps",
"title": "Cotlet: apps I can use",
"description": "The apps of the user's workspace and whether each works now: the app account in the user's Cloud Browser (connected, signed out, signed in but not connected), and the one step the user has to take, with the console link. Free. Needs the user's Cotlet API key or sign-in.",
"inputSchema": {
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "Only this app, e.g. skool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: apps I can use",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Requests access to apps for the user's workspace, as Request access in the console: every app is granted at once. Not needed to work in an app: the user's AI works in any web app in their Web browser with cotlet_app_guide. An app with dedicated tools gets them after the user signs in to it in their Cloud Browser. Access says nothing about whether a task works there: check that in the browser. Takes app slugs as listed at https://cotlet.dev/api/v1/apps. Free. Needs the user's Cotlet API key or sign-in.
| Parameter | Type | Description |
|---|---|---|
| apps * | array | App slugs, e.g. ["skool", "substack"]. |
| use_case | string | What the user wants the agent to do in these apps, in their words. |
{
"name": "cotlet_request_apps",
"title": "Cotlet: request access to apps",
"description": "Requests access to apps for the user's workspace, as Request access in the console: every app is granted at once. Not needed to work in an app: the user's AI works in any web app in their Web browser with cotlet_app_guide. An app with dedicated tools gets them after the user signs in to it in their Cloud Browser. Access says nothing about whether a task works there: check that in the browser. Takes app slugs as listed at https://cotlet.dev/api/v1/apps. Free. Needs the user's Cotlet API key or sign-in.",
"inputSchema": {
"type": "object",
"required": [
"apps"
],
"properties": {
"apps": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"description": "App slugs, e.g. [\"skool\", \"substack\"]."
},
"use_case": {
"type": "string",
"maxLength": 1000,
"description": "What the user wants the agent to do in these apps, in their words."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: request access to apps",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Status of an earlier Cotlet call, by its call_id: pending (waits for the owner's approval in the Cotlet console), approved, running, success, rejected, expired, blocked or failed. For a call that answered with status pending or running.
| Parameter | Type | Description |
|---|---|---|
| call_id * | string | call_id from the earlier call |
{
"name": "cotlet_get_call",
"title": "Cotlet: check a call",
"description": "Status of an earlier Cotlet call, by its call_id: pending (waits for the owner's approval in the Cotlet console), approved, running, success, rejected, expired, blocked or failed. For a call that answered with status pending or running.",
"inputSchema": {
"type": "object",
"required": [
"call_id"
],
"properties": {
"call_id": {
"type": "string",
"description": "call_id from the earlier call"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: check a call",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Returns a one-time upload_url and a file_id for a local file (an image for a post, an attachment). The file is sent to upload_url with an HTTP PUT; an argument that takes a file accepts {"file_id": "..."}. Up to 25 MB, the URL takes one stored file (a failed PUT can be sent again). Free. Needs the user's Cotlet API key or sign-in.
| Parameter | Type | Description |
|---|---|---|
| name | string | File name, e.g. photo.jpg. |
| content_type | string | MIME type, e.g. image/jpeg. |
{
"name": "cotlet_upload_file",
"title": "Cotlet: upload a file for a tool",
"description": "Returns a one-time upload_url and a file_id for a local file (an image for a post, an attachment). The file is sent to upload_url with an HTTP PUT; an argument that takes a file accepts {\"file_id\": \"...\"}. Up to 25 MB, the URL takes one stored file (a failed PUT can be sent again). Free. Needs the user's Cotlet API key or sign-in.",
"inputSchema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "File name, e.g. photo.jpg."
},
"content_type": {
"type": "string",
"description": "MIME type, e.g. image/jpeg."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: upload a file for a tool",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Sends a report to the Cotlet team: a tool that failed or returned wrong data, an error you could not get past, or a step the browser could not do, with the page, the step and what you saw. A missing dedicated tool is not a problem to report: do the task in the browser. A feature the user asks for goes as feature_request. A report promises nothing: tell the user it was sent, never that something will be built or fixed, or when. The report carries the error text and call_id when there is one, never passwords or tokens. Needs the user's Cotlet API key or sign-in.
| Parameter | Type | Description |
|---|---|---|
| app | any | App slug the report is about, e.g. 'skool', or for a site in the web browser its host, e.g. 'app.example.com'. |
| kind * | string | bug: a tool did the wrong thing or returned wrong data. error: a call failed or returned an error you could not get past. feature_request: something new the user asked for. missing_feature: a step the task needed that you tried and could not do, in the browser or with a tool. other: anything else. |
| tool | any | Tool or endpoint name, e.g. 'skool_list_members'. |
| title * | string | One line, e.g. 'skool_list_members stops after 50 members'. |
| client | any | Agent or tool sending this, e.g. 'Claude Code'. |
| call_id | any | call_id of the call that went wrong, if any. |
| description * | string | What the user asked for, what you tried, what you expected and what happened, with the error text if there was one. No passwords, tokens or other secrets. |
Starts the user's Milanote Cloud Browser (a real Chrome on Cotlet, signed in to Milanote as the user; use it for what the Milanote tools do not cover) and opens `url`. Call it first. Only Milanote pages open. Answers the page after it: the elements and text in view, with the same numbers. In Milanote it serves these actions: List boards, Add note, Add link, Upload image, Move and edit cards, Tick off tasks, Duplicate board, Share read-only link, Export board.
| Parameter | Type | Description |
|---|---|---|
| url | string | A public http or https address, e.g. https://example.com. |
{
"name": "cotlet_browser_open",
"title": "Open the browser",
"description": "Starts the user's Milanote Cloud Browser (a real Chrome on Cotlet, signed in to Milanote as the user; use it for what the Milanote tools do not cover) and opens `url`. Call it first. Only Milanote pages open. Answers the page after it: the elements and text in view, with the same numbers. In Milanote it serves these actions: List boards, Add note, Add link, Upload image, Move and edit cards, Tick off tasks, Duplicate board, Share read-only link, Export board.",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "A public http or https address, e.g. https://example.com."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Open the browser",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Opens `url` in the current tab, or goes `history` back or forward. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| url | string | A public http or https address, e.g. https://example.com. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| history | string | Instead of `url`. |
| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
{
"name": "cotlet_browser_navigate",
"title": "Go to a page",
"description": "Opens `url` in the current tab, or goes `history` back or forward. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"url": {
"type": "string",
"format": "uri",
"description": "A public http or https address, e.g. https://example.com."
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"history": {
"enum": [
"back",
"forward"
],
"type": "string",
"description": "Instead of `url`."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Go to a page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}The whole current page: its text (up to 20,000 characters) and a numbered list of its links, buttons, fields and other controls, open dialogs first. Use it on a new page or when a step's answer is not enough; `element` reads only inside one element (a dialog, a form, a list). Never returns field values, cookies or storage.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| element | integer | Read only inside this element. |
{
"name": "cotlet_browser_read",
"title": "Read the page",
"description": "The whole current page: its text (up to 20,000 characters) and a numbered list of its links, buttons, fields and other controls, open dialogs first. Use it on a new page or when a step's answer is not enough; `element` reads only inside one element (a dialog, a form, a list). Never returns field values, cookies or storage.",
"inputSchema": {
"type": "object",
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "Read only inside this element."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Read the page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Finds `text` on the whole current page, frames included: the elements whose label holds it, with their numbers, and each line of text that holds it. Use it instead of reading or scrolling a long page for one thing.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| kind | string | Only elements of this kind. Default: any. |
| text * | string | Words to look for, any case. |
{
"name": "cotlet_browser_find",
"title": "Find on the page",
"description": "Finds `text` on the whole current page, frames included: the elements whose label holds it, with their numbers, and each line of text that holds it. Use it instead of reading or scrolling a long page for one thing.",
"inputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"kind": {
"enum": [
"link",
"button",
"field",
"any"
],
"type": "string",
"description": "Only elements of this kind. Default: any."
},
"text": {
"type": "string",
"maxLength": 200,
"description": "Words to look for, any case."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Find on the page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}A JPEG of the visible part of the page. Use it for boards, canvases, maps, charts and layout that the text does not show, then click or drag by `x`, `y` of the image.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
{
"name": "cotlet_browser_screenshot",
"title": "See the page",
"description": "A JPEG of the visible part of the page. Use it for boards, canvases, maps, charts and layout that the text does not show, then click or drag by `x`, `y` of the image.",
"inputSchema": {
"type": "object",
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
}
},
"additionalProperties": false
},
"annotations": {
"title": "See the page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Scrolls with the mouse wheel: `down` or `up` by `screens`, to `top` or `bottom`, until `element` is in view, or inside a panel or list (`inside`). Content that loads on scroll appears. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| inside | integer | Scroll inside this element, not the page. |
| element | integer | Scroll until this element is in view. |
| screens | number | Viewport heights, for down and up. Default: 0.8. |
| direction | string | Default: down. |
{
"name": "cotlet_browser_scroll",
"title": "Scroll the page",
"description": "Scrolls with the mouse wheel: `down` or `up` by `screens`, to `top` or `bottom`, until `element` is in view, or inside a panel or list (`inside`). Content that loads on scroll appears. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"inside": {
"type": "integer",
"minimum": 1,
"description": "Scroll inside this element, not the page."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "Scroll until this element is in view."
},
"screens": {
"type": "number",
"maximum": 10,
"description": "Viewport heights, for down and up. Default: 0.8.",
"exclusiveMinimum": 0
},
"direction": {
"enum": [
"down",
"up",
"top",
"bottom"
],
"type": "string",
"description": "Default: down."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Scroll the page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Clicks element `element`, or point `x`, `y` of the screenshot; `double` double-clicks, `button: right` right-clicks. Answers the page after it: the elements and text in view, with the same numbers. Says when nothing changed. A link that would open a new tab opens in this one. Buttons that pay or buy, and sign-in and account pages, are refused.
| Parameter | Type | Description |
|---|---|---|
| x | number | Instead of `element`: pixels from the left of the screenshot. |
| y | number | With `x`: pixels from the top of the screenshot. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| button | string | right opens the page's own context menu. Default: left. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| double | boolean | Double-click. |
| element | integer | The element's number from the last read or step answer. |
| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
Rests the pointer on an element or a point, to open a hover menu, a tooltip or a preview. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| x | number | Instead of `element`: pixels from the left of the screenshot. |
| y | number | With `x`: pixels from the top of the screenshot. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| element | integer | The element's number from the last read or step answer. |
{
"name": "cotlet_browser_hover",
"title": "Point at the page",
"description": "Rests the pointer on an element or a point, to open a hover menu, a tooltip or a preview. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"properties": {
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Point at the page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Drags from one element or point to another: a card between columns, a piece on a board, a slider's handle. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| to * | object | An element number, or x and y of the screenshot. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| from * | object | An element number, or x and y of the screenshot. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
{
"name": "cotlet_browser_drag",
"title": "Drag on the page",
"description": "Drags from one element or point to another: a card between columns, a piece on a board, a slider's handle. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "object",
"properties": {
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
}
},
"description": "An element number, or x and y of the screenshot.",
"additionalProperties": false
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"from": {
"type": "object",
"properties": {
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
}
},
"description": "An element number, or x and y of the screenshot.",
"additionalProperties": false
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Drag on the page",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Types `text` into field `element`, replacing what it held; `submit` presses Enter after it. For several fields use fill_form. Without `element` the text goes where the focus is, as a person types after clicking: for spreadsheet cells and editors that read does not number (Google Sheets, Docs), click the place first; there a tab in `text` presses Tab and a line break Enter, so one call fills a table. Answers the page after it: the elements and text in view, with the same numbers. A password or code the user gave you goes in like any text; card fields are refused.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| text * | string | The text to type. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| slowly | boolean | Key by key, for a search or address field whose suggestions do not appear. |
| submit | boolean | Press Enter after typing, e.g. to search. |
| element | integer | The field's number from the last read. Leave it out to type where the focus is. |
| dialog_text | string |
Fills several fields in one step: text fields take text, drop-downs an option's label, checkboxes, radios and switches true or false. Stops at the first field that fails and names those filled. Does not send the form: click its button after. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| fields * | array | The fields in the order a person fills them. |
| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
{
"name": "cotlet_browser_fill_form",
"title": "Fill in a form",
"description": "Fills several fields in one step: text fields take text, drop-downs an option's label, checkboxes, radios and switches true or false. Stops at the first field that fails and names those filled. Does not send the form: click its button after. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"required": [
"fields"
],
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"element",
"value"
],
"properties": {
"value": {
"type": [
"string",
"boolean"
],
"description": "Text, option, or true/false."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
}
},
"additionalProperties": false
},
"maxItems": 30,
"minItems": 1,
"description": "The fields in the order a person fills them."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Fill in a form",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Chooses `option` (its label as listed, or its value) in drop-down `element`. For a home-made drop-down, click it, then click the option. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| option * | string | The option. |
| element * | integer | The element's number from the last read or step answer. |
| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
{
"name": "cotlet_browser_select",
"title": "Choose from a list",
"description": "Chooses `option` (its label as listed, or its value) in drop-down `element`. For a home-made drop-down, click it, then click the option. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"required": [
"element",
"option"
],
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"option": {
"type": "string",
"maxLength": 300,
"description": "The option."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Choose from a list",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Presses a key on the focused element: Enter to send, Tab to the next field, Escape to close a pop-up, arrows in a list or slider, or one character (a site's shortcut). Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| key * | string | One of Enter, Tab, Shift+Tab, Escape, Backspace, Delete, Space, ArrowDown, ArrowUp, ArrowLeft, ArrowRight, PageDown, PageUp, Home, End, or one character such as a or 5. |
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| dialog | string | How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog. |
| repeat | integer | Times to press it. Default 1. |
| dialog_text | string | Text for a prompt dialog this step opens; implies accept. |
{
"name": "cotlet_browser_press",
"title": "Press a key",
"description": "Presses a key on the focused element: Enter to send, Tab to the next field, Escape to close a pop-up, arrows in a list or slider, or one character (a site's shortcut). Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"required": [
"key"
],
"properties": {
"key": {
"type": "string",
"anyOf": [
{
"enum": [
"Enter",
"Tab",
"Shift+Tab",
"Escape",
"Backspace",
"Delete",
"Space",
"ArrowDown",
"ArrowUp",
"ArrowLeft",
"ArrowRight",
"PageDown",
"PageUp",
"Home",
"End"
]
},
{
"pattern": "^[ -~]$"
}
],
"description": "One of Enter, Tab, Shift+Tab, Escape, Backspace, Delete, Space, ArrowDown, ArrowUp, ArrowLeft, ArrowRight, PageDown, PageUp, Home, End, or one character such as a or 5."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"repeat": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Times to press it. Default 1."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Press a key",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Puts files into file field or upload button `element`: each file is {"url": "https://..."} or {"file_id": "..."} of a file uploaded to Cotlet; up to 10 files, 20 MB each. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| files * | array | The files. |
| element * | integer | The element's number from the last read or step answer. |
{
"name": "cotlet_browser_upload",
"title": "Upload a file",
"description": "Puts files into file field or upload button `element`: each file is {\"url\": \"https://...\"} or {\"file_id\": \"...\"} of a file uploaded to Cotlet; up to 10 files, 20 MB each. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"required": [
"element",
"files"
],
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"files": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "A public file URL."
},
"file_id": {
"type": "string",
"description": "A file uploaded to Cotlet."
}
},
"additionalProperties": false
},
"maxItems": 10,
"minItems": 1,
"description": "The files."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Upload a file",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Gets the file that clicking `element` (a download link or button) or opening `url` starts, also an image or PDF it only opens: answers its name, type, size and a link valid 15 minutes; CSV, JSON and other text files also as text.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| url | string | A public http or https address, e.g. https://example.com. |
| element | integer | The element's number from the last read or step answer. |
{
"name": "cotlet_browser_download",
"title": "Download a file",
"description": "Gets the file that clicking `element` (a download link or button) or opening `url` starts, also an image or PDF it only opens: answers its name, type, size and a link valid 15 minutes; CSV, JSON and other text files also as text.",
"inputSchema": {
"type": "object",
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"url": {
"type": "string",
"format": "uri",
"description": "A public http or https address, e.g. https://example.com."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Download a file",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Runs a JavaScript function body on the page and answers what it returns, as JSON. Use it to extract data the page holds (a table, a list, attributes); act with the other tools. It cannot send requests, click, submit, or read cookies or storage; a filled field's value reads [hidden by Cotlet]. Example: return [...document.querySelectorAll('h2')].map(h => h.innerText)
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| script * | string | A function body that returns. |
{
"name": "cotlet_browser_evaluate",
"title": "Run a script on the page",
"description": "Runs a JavaScript function body on the page and answers what it returns, as JSON. Use it to extract data the page holds (a table, a list, attributes); act with the other tools. It cannot send requests, click, submit, or read cookies or storage; a filled field's value reads [hidden by Cotlet]. Example: return [...document.querySelectorAll('h2')].map(h => h.innerText)",
"inputSchema": {
"type": "object",
"required": [
"script"
],
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"script": {
"type": "string",
"maxLength": 20000,
"description": "A function body that returns."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Run a script on the page",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Waits until `text` shows on the page (at most `seconds`, default 5, up to 20), or just `seconds`: for results that load slowly. Says whether the text appeared. Answers the page after it: the elements and text in view, with the same numbers.
| Parameter | Type | Description |
|---|---|---|
| tab | string | The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab. |
| text | string | Text to wait for. |
| seconds | number | At most. |
{
"name": "cotlet_browser_wait",
"title": "Wait for the page",
"description": "Waits until `text` shows on the page (at most `seconds`, default 5, up to 20), or just `seconds`: for results that load slowly. Says whether the text appeared. Answers the page after it: the elements and text in view, with the same numbers.",
"inputSchema": {
"type": "object",
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"text": {
"type": "string",
"maxLength": 200,
"description": "Text to wait for."
},
"seconds": {
"type": "number",
"maximum": 20,
"description": "At most.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"title": "Wait for the page",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Ends the browser session when the task is done: the browser keeps its cookies and sleeps, and the per-minute charge stops. Answers the session's minutes and credits.
No parameters.
{
"name": "cotlet_browser_close",
"title": "Close the browser",
"description": "Ends the browser session when the task is done: the browser keeps its cookies and sleeps, and the per-minute charge stops. Answers the session's minutes and credits.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Close the browser",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}How to work in an app by clicking in the user's Cloud Browser with Cotlet's browser tools: which browser to use for this workspace and the sign-in link, the method step by step, the app's screens, menus and actions, notes, and the app's dedicated tools when Cotlet has them. Call it before the first browser step in an app. Works for any web app; one outside Cotlet's catalog gets the general method. Free, no browser session. For Milanote it covers these actions: List boards, Add note, Add link, Upload image, Move and edit cards, Tick off tasks, Duplicate board, Share read-only link, Export board.
| Parameter | Type | Description |
|---|---|---|
| app | string | The app's name or Cotlet slug. Default: Milanote. |
| task | string | What the user wants done in the app, in their words. |
{
"name": "cotlet_app_guide",
"title": "Cotlet: how to work in an app",
"description": "How to work in an app by clicking in the user's Cloud Browser with Cotlet's browser tools: which browser to use for this workspace and the sign-in link, the method step by step, the app's screens, menus and actions, notes, and the app's dedicated tools when Cotlet has them. Call it before the first browser step in an app. Works for any web app; one outside Cotlet's catalog gets the general method. Free, no browser session. For Milanote it covers these actions: List boards, Add note, Add link, Upload image, Move and edit cards, Tick off tasks, Duplicate board, Share read-only link, Export board.",
"inputSchema": {
"type": "object",
"properties": {
"app": {
"type": "string",
"maxLength": 120,
"description": "The app's name or Cotlet slug. Default: Milanote."
},
"task": {
"type": "string",
"maxLength": 500,
"description": "What the user wants done in the app, in their words."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: how to work in an app",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Export a board as Markdown, plain text, Word, PDF or PNG, as the Export menu does. Runs Milanote's own export of one board. markdown and plain_text return the text in content; word, pdf and png return only file_url. Text formats follow the board's reading order and leave out comments and sub-board contents; pdf and png are a picture of the canvas. Anyone with file_url can download the file, and Milanote deletes it after about a day.
| Parameter | Type | Description |
|---|---|---|
| format * | string | markdown, plain_text, word, pdf or png. |
| board_id * | string | Board ID from list_boards, or the board URL. |
{
"name": "export_board",
"title": "Export board",
"description": "Export a board as Markdown, plain text, Word, PDF or PNG, as the Export menu does. Runs Milanote's own export of one board. markdown and plain_text return the text in content; word, pdf and png return only file_url. Text formats follow the board's reading order and leave out comments and sub-board contents; pdf and png are a picture of the canvas. Anyone with file_url can download the file, and Milanote deletes it after about a day.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"format"
],
"properties": {
"format": {
"enum": [
"markdown",
"plain_text",
"word",
"pdf",
"png"
],
"type": "string",
"description": "markdown, plain_text, word, pdf or png."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Export board",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Every card on a board: notes, links, images, files, to-do lists, columns and sub-boards. Returns one entry per card with its type, ID and content, so other tools can point at it. Order is the board's: the canvas top to bottom, then the Unsorted panel (section says which). Notes come back as plain text. To-do lists list each task with its done state and due date (due_time only when one was set). Cards inside a column carry column_id; color and labels (by name) appear when a card has them. Sub-boards appear as cards with their own board_id; call get_board again to open one. Drawings, lines and tables come back with their type and ID only. include_comments adds comment threads with author, text and time.
| Parameter | Type | Description |
|---|---|---|
| board_id * | string | Board ID from list_boards, or the board URL. |
| include_comments | boolean | Also return comment threads with their comments. Default: false. |
{
"name": "get_board",
"title": "Get board",
"description": "Every card on a board: notes, links, images, files, to-do lists, columns and sub-boards. Returns one entry per card with its type, ID and content, so other tools can point at it. Order is the board's: the canvas top to bottom, then the Unsorted panel (section says which). Notes come back as plain text. To-do lists list each task with its done state and due date (due_time only when one was set). Cards inside a column carry column_id; color and labels (by name) appear when a card has them. Sub-boards appear as cards with their own board_id; call get_board again to open one. Drawings, lines and tables come back with their type and ID only. include_comments adds comment threads with author, text and time.",
"inputSchema": {
"type": "object",
"required": [
"board_id"
],
"properties": {
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
},
"include_comments": {
"type": "boolean",
"description": "Also return comment threads with their comments. Default: false."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get board",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Who can open a board: owner, editors and the read-only link with its settings. Lists the board's owner and the editors invited to it; status is invited for someone who has not made a Milanote account yet. Editors of a parent board can open it too and are not listed here. read_only_link is null until publish_board turns the link on; comments_on_link and downloads_on_link say what viewers of that link may do.
| Parameter | Type | Description |
|---|---|---|
| board_id * | string | Board ID from list_boards, or the board URL. |
{
"name": "get_sharing",
"title": "Get sharing",
"description": "Who can open a board: owner, editors and the read-only link with its settings. Lists the board's owner and the editors invited to it; status is invited for someone who has not made a Milanote account yet. Editors of a parent board can open it too and are not listed here. read_only_link is null until publish_board turns the link on; comments_on_link and downloads_on_link say what viewers of that link may do.",
"inputSchema": {
"type": "object",
"required": [
"board_id"
],
"properties": {
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get sharing",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}How many cards your account uses against the free plan's limit, by card type. used is what Milanote counts toward the free plan's limit (100 cards, more with referral bonuses); once exceeded is true Milanote refuses new cards until you delete some or upgrade. On a paid plan unlimited is true and limit is null. by_type counts each kind of element you made, comments and lines included; Milanote decides which of them count toward used.
No parameters.
{
"name": "get_usage",
"title": "Get usage",
"description": "How many cards your account uses against the free plan's limit, by card type. used is what Milanote counts toward the free plan's limit (100 cards, more with referral bonuses); once exceeded is true Milanote refuses new cards until you delete some or upgrade. On a paid plan unlimited is true and limit is null. by_type counts each kind of element you made, comments and lines included; Milanote decides which of them count toward used.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Get usage",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Boards inside one board, by default the boards on your Home, with title, ID and link. Lists the boards one level down: on your Home, or inside parent_board_id. Boards nest like folders, so pass a board's id as parent_board_id to walk down. Order is the board's own: the canvas top to bottom, then Unsorted. parent_board_id in the answer is the Home board's id when you left it out. Boards in the trash are left out.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | 1 to 200. Default: 50. |
| parent_board_id | string | Only boards inside this board (ID or board URL). Default: the boards on your Home. |
{
"name": "list_boards",
"title": "List boards",
"description": "Boards inside one board, by default the boards on your Home, with title, ID and link. Lists the boards one level down: on your Home, or inside parent_board_id. Boards nest like folders, so pass a board's id as parent_board_id to walk down. Order is the board's own: the canvas top to bottom, then Unsorted. parent_board_id in the answer is the Home board's id when you left it out. Boards in the trash are left out.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"description": "1 to 200. Default: 50."
},
"parent_board_id": {
"type": "string",
"description": "Only boards inside this board (ID or board URL). Default: the boards on your Home."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List boards",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}The labels you can put on cards, with name and colour. Labels are yours, not a board's: the same label can sit on cards across all your boards. add_label puts one on a card by name and creates it when it is new.
No parameters.
{
"name": "list_labels",
"title": "List labels",
"description": "The labels you can put on cards, with name and colour. Labels are yours, not a board's: the same label can sit on cards across all your boards. add_label puts one on a card by name and creates it when it is new.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "List labels",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Boards you opened lately, newest first, wherever they sit in your board tree. The list behind Milanote's search box before you type: every board you viewed, shared ones too, with when you last opened it and how many times. Home and Quick notes appear like any other board. Boards you have not opened since they were made are missing; list_boards walks the tree instead.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | 1 to 50. Default 20. |
{
"name": "list_recent_boards",
"title": "List recent boards",
"description": "Boards you opened lately, newest first, wherever they sit in your board tree. The list behind Milanote's search box before you type: every board you viewed, shared ones too, with when you last opened it and how many times. Home and Quick notes appear like any other board. Boards you have not opened since they were made are missing; list_boards walks the tree instead.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "1 to 50. Default 20."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List recent boards",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Every task in the to-do lists of your boards and the boards inside them, with due dates. Walks down from Home, or from board_ids, through every board inside, and returns each task with its board, to-do list, text, done state and due date (due_time only when one was set). Reads up to 100 boards; boards_read says how many it read. Order is the boards' own: a board's lists top to bottom, then the boards inside it. done filters open or done tasks. Use set_task_done, set_due_date and add_task with the board_id and card_id it returns.
| Parameter | Type | Description |
|---|---|---|
| done | boolean | true only done tasks, false only open ones. Default: both. |
| limit | integer | 1 to 500 tasks. Default: 200. |
| board_ids | array | Boards to read (IDs or board URLs), with the boards inside them. Default: Home. |
{
"name": "list_tasks",
"title": "List tasks",
"description": "Every task in the to-do lists of your boards and the boards inside them, with due dates. Walks down from Home, or from board_ids, through every board inside, and returns each task with its board, to-do list, text, done state and due date (due_time only when one was set). Reads up to 100 boards; boards_read says how many it read. Order is the boards' own: a board's lists top to bottom, then the boards inside it. done filters open or done tasks. Use set_task_done, set_due_date and add_task with the board_id and card_id it returns.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"done": {
"type": "boolean",
"description": "true only done tasks, false only open ones. Default: both."
},
"limit": {
"type": "integer",
"description": "1 to 500 tasks. Default: 200."
},
"board_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Boards to read (IDs or board URLs), with the boards inside them. Default: Home."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List tasks",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Cards and boards you moved to the trash, with the board each one came from. Lists your own trash, newest first: one entry per trashed card or board with its ID, content and board_id of the board it was on. restore_card puts one back where it was. Milanote keeps trashed items until you empty the trash in the app; has_more is true when it holds more than one page.
No parameters.
{
"name": "list_trash",
"title": "List trash",
"description": "Cards and boards you moved to the trash, with the board each one came from. Lists your own trash, newest first: one entry per trashed card or board with its ID, content and board_id of the board it was on. restore_card puts one back where it was. Milanote keeps trashed items until you empty the trash in the app; has_more is true when it holds more than one page.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "List trash",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Find boards and cards by text across your boards, like the Search icon in Milanote. Runs Milanote's own search over every board you can open. Each result is a board, with the cards on it that matched (matches) and the boards above it (path). A board whose title matched has no matches. Sorted by when you last viewed the board, or last modified. Returns Milanote's first page of boards; use get_board on a result to read all its cards.
| Parameter | Type | Description |
|---|---|---|
| sort | string | last_viewed or last_modified. Default: last_viewed. |
| query * | string | Text to look for. |
{
"name": "search_boards",
"title": "Search boards",
"description": "Find boards and cards by text across your boards, like the Search icon in Milanote. Runs Milanote's own search over every board you can open. Each result is a board, with the cards on it that matched (matches) and the boards above it (path). A board whose title matched has no matches. Sorted by when you last viewed the board, or last modified. Returns Milanote's first page of boards; use get_board on a result to read all its cards.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"sort": {
"enum": [
"last_viewed",
"last_modified"
],
"type": "string",
"description": "last_viewed or last_modified. Default: last_viewed."
},
"query": {
"type": "string",
"description": "Text to look for."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search boards",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Empty column on a board, to group cards in a stack. Adds a titled column on top of the board's Unsorted panel and returns its column_id; move_card with to_column_id puts cards into it. Editors of the board see it, nobody is notified.
| Parameter | Type | Description |
|---|---|---|
| title * | string | Column title. |
| board_id * | string | Board ID from list_boards, or the board URL. |
{
"name": "add_column",
"title": "Add column",
"description": "Empty column on a board, to group cards in a stack. Adds a titled column on top of the board's Unsorted panel and returns its column_id; move_card with to_column_id puts cards into it. Editors of the board see it, nobody is notified.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"title"
],
"properties": {
"title": {
"type": "string",
"description": "Column title."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Add column",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Comment card on a board, or a reply in a comment thread, posted under your name. Without reply_to_id it adds a new comment card on top of the board's Unsorted panel; with it the comment joins that thread. Everyone who can open the board sees it under your name, and Milanote notifies people already in the thread. The text is plain: an @name stays text and tags nobody. Only you can edit or delete it afterwards, in Milanote. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| text * | string | Comment text, plain. |
| board_id * | string | Board ID from list_boards, or the board URL. |
| reply_to_id | string | A comment thread ID or comment ID from get_board (include_comments) to reply in. Default: a new comment card. |
{
"name": "add_comment",
"title": "Add comment",
"description": "Comment card on a board, or a reply in a comment thread, posted under your name. Without reply_to_id it adds a new comment card on top of the board's Unsorted panel; with it the comment joins that thread. Everyone who can open the board sees it under your name, and Milanote notifies people already in the thread. The text is plain: an @name stays text and tags nobody. Only you can edit or delete it afterwards, in Milanote. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"text"
],
"properties": {
"text": {
"type": "string",
"description": "Comment text, plain."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
},
"reply_to_id": {
"type": "string",
"description": "A comment thread ID or comment ID from get_board (include_comments) to reply in. Default: a new comment card."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Add comment",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Put a label on a card, creating the label when the name is new. Matches the name against your labels (list_labels) without regard to case; created is true when it made a new one. The card keeps its other labels. Editors of the board see the label on the card.
| Parameter | Type | Description |
|---|---|---|
| label * | string | Label name; a name you have not used yet creates the label. |
| card_id * | string | Card ID from get_board. |
| board_id * | string | Board ID from list_boards, or the board URL. |
{
"name": "add_label",
"title": "Add label",
"description": "Put a label on a card, creating the label when the name is new. Matches the name against your labels (list_labels) without regard to case; created is true when it made a new one. The card keeps its other labels. Editors of the board see the label on the card.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"card_id",
"label"
],
"properties": {
"label": {
"type": "string",
"description": "Label name; a name you have not used yet creates the label."
},
"card_id": {
"type": "string",
"description": "Card ID from get_board."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Add label",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Link card for a web address, with the page's title and preview, added to Unsorted. Adds one link card on top of the board's Unsorted panel. Milanote fetches the page itself and fills in the title, description and preview image, as when you paste a link; the answer returns what it found (title is null when the page gave none). On the free plan a link counts toward the 100 cards limit. Nobody is notified; move the card to the trash in Milanote to undo it.
| Parameter | Type | Description |
|---|---|---|
| url * | string | Web address to save, starting with http:// or https://. |
| board_id * | string | Board ID from list_boards, or the board URL. |
{
"name": "add_link",
"title": "Add link",
"description": "Link card for a web address, with the page's title and preview, added to Unsorted. Adds one link card on top of the board's Unsorted panel. Milanote fetches the page itself and fills in the title, description and preview image, as when you paste a link; the answer returns what it found (title is null when the page gave none). On the free plan a link counts toward the 100 cards limit. Nobody is notified; move the card to the trash in Milanote to undo it.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Web address to save, starting with http:// or https://."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Add link",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Note card with plain text, added to a board's Unsorted panel. Adds one note card on top of the board's Unsorted panel and returns its card_id. The text is plain: line breaks become paragraphs, Markdown is not converted. On the free plan a note counts toward the 100 cards limit. Editors of the board see it, nobody is notified; move it to the trash in Milanote to undo it.
| Parameter | Type | Description |
|---|---|---|
| text * | string | Note text. Each line becomes a paragraph. |
| board_id * | string | Board ID from list_boards, or the board URL. |
{
"name": "add_note",
"title": "Add note",
"description": "Note card with plain text, added to a board's Unsorted panel. Adds one note card on top of the board's Unsorted panel and returns its card_id. The text is plain: line breaks become paragraphs, Markdown is not converted. On the free plan a note counts toward the 100 cards limit. Editors of the board see it, nobody is notified; move it to the trash in Milanote to undo it.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"text"
],
"properties": {
"text": {
"type": "string",
"description": "Note text. Each line becomes a paragraph."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Add note",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Up to 15 note cards in one call, into Unsorted or a column, in the order given. Creates one note card per text, in the order given, on top of the board's Unsorted panel or of a column, and returns each card_id. The text is plain: line breaks become paragraphs, Markdown is not converted, any script (Chinese, Arabic, emoji) is kept. Each note counts toward the free plan's 100 cards limit; get_usage shows what is left. If Milanote stops partway, the answer is an error and the notes made before it stay on the board. Editors of the board see them, nobody is notified.
| Parameter | Type | Description |
|---|---|---|
| notes * | array | 1 to 15 note texts, in order. Each line of a text becomes a paragraph. |
| board_id * | string | Board ID from list_boards, or the board URL. |
| column_id | string | Column on the board (from get_board) to put the notes in, at the top. Default: the board's Unsorted panel. |
{
"name": "add_notes",
"title": "Add notes",
"description": "Up to 15 note cards in one call, into Unsorted or a column, in the order given. Creates one note card per text, in the order given, on top of the board's Unsorted panel or of a column, and returns each card_id. The text is plain: line breaks become paragraphs, Markdown is not converted, any script (Chinese, Arabic, emoji) is kept. Each note counts toward the free plan's 100 cards limit; get_usage shows what is left. If Milanote stops partway, the answer is an error and the notes made before it stay on the board. Editors of the board see them, nobody is notified.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"notes"
],
"properties": {
"notes": {
"type": "array",
"items": {
"type": "string"
},
"description": "1 to 15 note texts, in order. Each line of a text becomes a paragraph."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
},
"column_id": {
"type": "string",
"description": "Column on the board (from get_board) to put the notes in, at the top. Default: the board's Unsorted panel."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Add notes",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Add tasks to the end of an existing to-do list, each with an optional due date and time. Appends the tasks, unchecked, after the last task of the list and returns the whole list with the new task_ids. The tasks already there stay as they were. A due date without a time is due at 5 PM; Milanote reminds you at 9 AM the day it's due. Times are in the Cloud Browser's time zone. Nobody else is notified. To start a new list, use add_todo_list.
| Parameter | Type | Description |
|---|---|---|
| tasks * | array | 1 to 50 tasks, added in order at the end of the list. |
| card_id * | string | To-do list ID from get_board. |
| board_id * | string | Board ID from list_boards, or the board URL. |
{
"name": "add_task",
"title": "Add task",
"description": "Add tasks to the end of an existing to-do list, each with an optional due date and time. Appends the tasks, unchecked, after the last task of the list and returns the whole list with the new task_ids. The tasks already there stay as they were. A due date without a time is due at 5 PM; Milanote reminds you at 9 AM the day it's due. Times are in the Cloud Browser's time zone. Nobody else is notified. To start a new list, use add_todo_list.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"card_id",
"tasks"
],
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "Task text."
},
"due_date": {
"type": "string",
"description": "YYYY-MM-DD. Default: no due date."
},
"due_time": {
"type": "string",
"description": "HH:MM, 24-hour, with due_date."
}
},
"additionalProperties": false
},
"description": "1 to 50 tasks, added in order at the end of the list."
},
"card_id": {
"type": "string",
"description": "To-do list ID from get_board."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Add task",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}To-do list card with tasks, each with an optional due date and time, added to Unsorted. Creates one to-do list on top of the board's Unsorted panel with all its tasks, unchecked, and returns each task_id. A due date without a time is due at 5 PM; Milanote reminds you at 9 AM the day it's due, by the channels in your notification settings. Times are in the Cloud Browser's time zone. Nobody else is notified; move the list to the trash in Milanote to undo it.
| Parameter | Type | Description |
|---|---|---|
| tasks * | array | 1 to 50 tasks, in order. |
| title | string | List title. Default: no title. |
| board_id * | string | Board ID from list_boards, or the board URL. |
{
"name": "add_todo_list",
"title": "Add to-do list",
"description": "To-do list card with tasks, each with an optional due date and time, added to Unsorted. Creates one to-do list on top of the board's Unsorted panel with all its tasks, unchecked, and returns each task_id. A due date without a time is due at 5 PM; Milanote reminds you at 9 AM the day it's due, by the channels in your notification settings. Times are in the Cloud Browser's time zone. Nobody else is notified; move the list to the trash in Milanote to undo it.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"tasks"
],
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "Task text."
},
"due_date": {
"type": "string",
"description": "YYYY-MM-DD. Default: no due date."
},
"due_time": {
"type": "string",
"description": "HH:MM, 24-hour, with due_date."
}
},
"additionalProperties": false
},
"description": "1 to 50 tasks, in order."
},
"title": {
"type": "string",
"description": "List title. Default: no title."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Add to-do list",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}New board on your Home or nested inside another board. Creates an empty board and returns its board_id for the tools that add cards. It appears in the Unsorted panel of the parent board (your Home by default), where you can drag it onto the canvas. It is private unless the parent board is shared, in which case the parent's editors can open it; nobody is notified. Move it to the trash in Milanote to undo it.
| Parameter | Type | Description |
|---|---|---|
| title * | string | Board title. |
| parent_board_id | string | Board to nest it in (ID or board URL). Default: your Home. |
{
"name": "create_board",
"title": "Create board",
"description": "New board on your Home or nested inside another board. Creates an empty board and returns its board_id for the tools that add cards. It appears in the Unsorted panel of the parent board (your Home by default), where you can drag it onto the canvas. It is private unless the parent board is shared, in which case the parent's editors can open it; nobody is notified. Move it to the trash in Milanote to undo it.",
"inputSchema": {
"type": "object",
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"description": "Board title."
},
"parent_board_id": {
"type": "string",
"description": "Board to nest it in (ID or board URL). Default: your Home."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Create board",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Delete a comment you wrote, for everyone. Removes your own comment from its thread; the thread and other people's comments stay. There is no trash for comments, so it cannot be brought back. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| board_id * | string | Board ID from list_boards, or the board URL. |
| comment_id * | string | comment_id from get_board (include_comments) or add_comment. |
{
"name": "delete_comment",
"title": "Delete comment",
"description": "Delete a comment you wrote, for everyone. Removes your own comment from its thread; the thread and other people's comments stay. There is no trash for comments, so it cannot be brought back. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"comment_id"
],
"properties": {
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
},
"comment_id": {
"type": "string",
"description": "comment_id from get_board (include_comments) or add_comment."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Delete comment",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Copy a board with everything on it, sub-boards included, as a template. Does what Duplicate in a board's menu does: Milanote copies every card, column, comment and sub-board into a new board and returns its board_id. The copy lands in the parent board's Unsorted panel, private to you unless that board is shared; the read-only link and editors are not copied. Every copied card counts toward the free plan's card limit (get_usage). card_count is what Milanote reports it copied.
| Parameter | Type | Description |
|---|---|---|
| title | string | Title of the copy. Default: the same title. |
| board_id * | string | Board to copy: ID or board URL. |
| parent_board_id | string | Board to put the copy in (ID or board URL). Default: where the original is. |
{
"name": "duplicate_board",
"title": "Duplicate board",
"description": "Copy a board with everything on it, sub-boards included, as a template. Does what Duplicate in a board's menu does: Milanote copies every card, column, comment and sub-board into a new board and returns its board_id. The copy lands in the parent board's Unsorted panel, private to you unless that board is shared; the read-only link and editors are not copied. Every copied card counts toward the free plan's card limit (get_usage). card_count is what Milanote reports it copied.",
"inputSchema": {
"type": "object",
"required": [
"board_id"
],
"properties": {
"title": {
"type": "string",
"description": "Title of the copy. Default: the same title."
},
"board_id": {
"type": "string",
"description": "Board to copy: ID or board URL."
},
"parent_board_id": {
"type": "string",
"description": "Board to put the copy in (ID or board URL). Default: where the original is."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Duplicate board",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Replace the text of a comment you wrote. Overwrites your own comment with plain text, as Edit then Save does in the thread. Others' comments cannot be changed. People who already read it get no new notification.
| Parameter | Type | Description |
|---|---|---|
| text * | string | New comment text, plain. |
| board_id * | string | Board ID from list_boards, or the board URL. |
| comment_id * | string | comment_id from get_board (include_comments) or add_comment. |
{
"name": "edit_comment",
"title": "Edit comment",
"description": "Replace the text of a comment you wrote. Overwrites your own comment with plain text, as Edit then Save does in the thread. Others' comments cannot be changed. People who already read it get no new notification.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"comment_id",
"text"
],
"properties": {
"text": {
"type": "string",
"description": "New comment text, plain."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
},
"comment_id": {
"type": "string",
"description": "comment_id from get_board (include_comments) or add_comment."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Edit comment",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Replace the text of a note card. Overwrites the whole note with plain text: line breaks become paragraphs, and bold, links or lists the note had are lost. Only note cards; to-do lists change with set_task_done. Editors of the board see the change at once; Milanote's undo in the app does not reach it.
| Parameter | Type | Description |
|---|---|---|
| text * | string | New note text. Each line becomes a paragraph. |
| card_id * | string | Note ID from get_board. |
| board_id * | string | Board ID from list_boards, or the board URL. |
{
"name": "edit_note",
"title": "Edit note",
"description": "Replace the text of a note card. Overwrites the whole note with plain text: line breaks become paragraphs, and bold, links or lists the note had are lost. Only note cards; to-do lists change with set_task_done. Editors of the board see the change at once; Milanote's undo in the app does not reach it.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"card_id",
"text"
],
"properties": {
"text": {
"type": "string",
"description": "New note text. Each line becomes a paragraph."
},
"card_id": {
"type": "string",
"description": "Note ID from get_board."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Edit note",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Invite someone by email to edit a board and the boards inside it. Adds the address as an editor, as Share, Invite editors via email does, and Milanote emails them a link. status is invited when they have no Milanote account yet (a free one is enough to edit), active when they do. Milanote allows inviting only once your account's email is verified; the free plan limits how many boards you can share. Remove them in the Share dialog to undo it. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Their email address. |
| board_id * | string | Board ID from list_boards, or the board URL. |
{
"name": "invite_editor",
"title": "Invite editor",
"description": "Invite someone by email to edit a board and the boards inside it. Adds the address as an editor, as Share, Invite editors via email does, and Milanote emails them a link. status is invited when they have no Milanote account yet (a free one is enough to edit), active when they do. Milanote allows inviting only once your account's email is verified; the free plan limits how many boards you can share. Remove them in the Share dialog to undo it. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Their email address."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Invite editor",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Move a card or a sub-board to another board, or into or out of a column. Moves it the way drag and drop does, keeping its ID, comments and content. With to_column_id it goes to the top of that column; without it, to the top of the target board's Unsorted panel. Moving a board moves everything inside it. Moving to a board shared with other people shows it to them.
| Parameter | Type | Description |
|---|---|---|
| card_id * | string | Card ID from get_board; a sub-board's board_id works too. |
| board_id * | string | Board the card is on now: ID or board URL. |
| to_board_id | string | Board to move it to. Default: the same board. |
| to_column_id | string | Column on the target board to put it in, at the top. Default: no column. |
{
"name": "move_card",
"title": "Move card",
"description": "Move a card or a sub-board to another board, or into or out of a column. Moves it the way drag and drop does, keeping its ID, comments and content. With to_column_id it goes to the top of that column; without it, to the top of the target board's Unsorted panel. Moving a board moves everything inside it. Moving to a board shared with other people shows it to them.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"card_id"
],
"properties": {
"card_id": {
"type": "string",
"description": "Card ID from get_board; a sub-board's board_id works too."
},
"board_id": {
"type": "string",
"description": "Board the card is on now: ID or board URL."
},
"to_board_id": {
"type": "string",
"description": "Board to move it to. Default: the same board."
},
"to_column_id": {
"type": "string",
"description": "Column on the target board to put it in, at the top. Default: no column."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Move card",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Turn on a board's read-only link, which anyone can open without signing up. Does what Share, Enable read-only link does and returns the link. Anyone who has it sees the board and the boards inside it, without a Milanote account. A board keeps one link: publishing again, even after unpublish_board, brings back the same link with these settings. unpublish_board turns it off. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| board_id * | string | Board ID from list_boards, or the board URL. |
| allow_comments | boolean | Let viewers of the link comment, react and draw. Default false. |
| allow_downloads | boolean | Show download links on files to viewers. Default true. |
{
"name": "publish_board",
"title": "Publish board",
"description": "Turn on a board's read-only link, which anyone can open without signing up. Does what Share, Enable read-only link does and returns the link. Anyone who has it sees the board and the boards inside it, without a Milanote account. A board keeps one link: publishing again, even after unpublish_board, brings back the same link with these settings. unpublish_board turns it off. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"board_id"
],
"properties": {
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
},
"allow_comments": {
"type": "boolean",
"description": "Let viewers of the link comment, react and draw. Default false."
},
"allow_downloads": {
"type": "boolean",
"description": "Show download links on files to viewers. Default true."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Publish board",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Take away someone's access to a board, or cancel an invite they have not accepted. Removes one editor, by user_id or email, as the Share dialog's Remove does. They lose the board and the boards inside it unless a parent board is shared with them too; Milanote does not tell them. The owner cannot be removed. invite_editor adds them back. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| string | Their email address, instead of user_id. | |
| user_id | string | Their user_id from get_sharing or invite_editor. |
| board_id * | string | Board ID from list_boards, or the board URL. |
{
"name": "remove_editor",
"title": "Remove editor",
"description": "Take away someone's access to a board, or cancel an invite they have not accepted. Removes one editor, by user_id or email, as the Share dialog's Remove does. They lose the board and the boards inside it unless a parent board is shared with them too; Milanote does not tell them. The owner cannot be removed. invite_editor adds them back. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"board_id"
],
"properties": {
"email": {
"type": "string",
"description": "Their email address, instead of user_id."
},
"user_id": {
"type": "string",
"description": "Their user_id from get_sharing or invite_editor."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Remove editor",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Change a board's title. Renames the board everywhere it shows: its card on the parent board, the breadcrumb and search. The board_id and the links to it stay the same. Your Home cannot be renamed.
| Parameter | Type | Description |
|---|---|---|
| title * | string | New title. |
| board_id * | string | Board ID from list_boards, or the board URL. |
{
"name": "rename_board",
"title": "Rename board",
"description": "Change a board's title. Renames the board everywhere it shows: its card on the parent board, the breadcrumb and search. The board_id and the links to it stay the same. Your Home cannot be renamed.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"title"
],
"properties": {
"title": {
"type": "string",
"description": "New title."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Rename board",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Take a card or board out of the trash and put it back where it was. Puts it back on the board, and in the column, it was trashed from, at its old place; a restored board comes back with its contents. column_id is set when it went back into a column. Only items in your own trash, as list_trash shows them.
| Parameter | Type | Description |
|---|---|---|
| card_id * | string | ID of a trashed card or board from list_trash. |
{
"name": "restore_card",
"title": "Restore card",
"description": "Take a card or board out of the trash and put it back where it was. Puts it back on the board, and in the column, it was trashed from, at its old place; a restored board comes back with its contents. column_id is set when it went back into a column. Only items in your own trash, as list_trash shows them.",
"inputSchema": {
"type": "object",
"required": [
"card_id"
],
"properties": {
"card_id": {
"type": "string",
"description": "ID of a trashed card or board from list_trash."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Restore card",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Colour the bar on top of a note, to-do list, link, file or column, or clear it. Sets one of Milanote's eleven card colours, as the Color tool does; none removes it. Boards and images take no colour here. Editors of the board see the change at once.
| Parameter | Type | Description |
|---|---|---|
| color * | string | Colour, or none to clear it. |
| card_id * | string | Card ID from get_board: a note, to-do list, link, file or column. |
| board_id * | string | Board ID from list_boards, or the board URL. |
{
"name": "set_card_color",
"title": "Set card color",
"description": "Colour the bar on top of a note, to-do list, link, file or column, or clear it. Sets one of Milanote's eleven card colours, as the Color tool does; none removes it. Boards and images take no colour here. Editors of the board see the change at once.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"card_id",
"color"
],
"properties": {
"color": {
"enum": [
"grey",
"cyan",
"green",
"brown",
"yellow",
"orange",
"red",
"pink",
"purple",
"blue",
"deep_blue",
"none"
],
"type": "string",
"description": "Colour, or none to clear it."
},
"card_id": {
"type": "string",
"description": "Card ID from get_board: a note, to-do list, link, file or column."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Set card color",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Set, change or remove the due date of one task in a to-do list. Finds the task by task_id or by its exact text and sets its due date, or removes it when due_date is null. A date without a time is due at 5 PM; Milanote reminds you at 9 AM the day it's due. Times are in the Cloud Browser's time zone. The task's text and done state stay as they were. Returns the whole list after the change. When two tasks share the text, pass the task_id instead.
| Parameter | Type | Description |
|---|---|---|
| task * | string | The task's task_id from get_board, or its exact text. |
| card_id * | string | To-do list ID from get_board. |
| board_id * | string | Board ID from list_boards, or the board URL. |
| due_date * | ["string","null"] | YYYY-MM-DD. null or an empty string removes the due date. |
| due_time | string | HH:MM, 24-hour, with due_date. Default: no time. |
{
"name": "set_due_date",
"title": "Set due date",
"description": "Set, change or remove the due date of one task in a to-do list. Finds the task by task_id or by its exact text and sets its due date, or removes it when due_date is null. A date without a time is due at 5 PM; Milanote reminds you at 9 AM the day it's due. Times are in the Cloud Browser's time zone. The task's text and done state stay as they were. Returns the whole list after the change. When two tasks share the text, pass the task_id instead.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"card_id",
"task",
"due_date"
],
"properties": {
"task": {
"type": "string",
"description": "The task's task_id from get_board, or its exact text."
},
"card_id": {
"type": "string",
"description": "To-do list ID from get_board."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
},
"due_date": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD. null or an empty string removes the due date."
},
"due_time": {
"type": "string",
"description": "HH:MM, 24-hour, with due_date. Default: no time."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Set due date",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Tick or untick one task in a to-do list. Finds the task by task_id or by its exact text and sets it done or not done, as clicking its checkbox does; the rest of the list stays as it was. Returns the whole list after the change. When two tasks share the text, pass the task_id instead.
| Parameter | Type | Description |
|---|---|---|
| done | boolean | true ticks it, false unticks it. Default true. |
| task * | string | The task's task_id from get_board, or its exact text. |
| card_id * | string | To-do list ID from get_board. |
| board_id * | string | Board ID from list_boards, or the board URL. |
{
"name": "set_task_done",
"title": "Set task done",
"description": "Tick or untick one task in a to-do list. Finds the task by task_id or by its exact text and sets it done or not done, as clicking its checkbox does; the rest of the list stays as it was. Returns the whole list after the change. When two tasks share the text, pass the task_id instead.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"card_id",
"task"
],
"properties": {
"done": {
"type": "boolean",
"description": "true ticks it, false unticks it. Default true."
},
"task": {
"type": "string",
"description": "The task's task_id from get_board, or its exact text."
},
"card_id": {
"type": "string",
"description": "To-do list ID from get_board."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Set task done",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Move cards or sub-boards to the trash, as the Delete key does. The cards leave the board for everyone who can see it, and a trashed sub-board takes its contents with it. Nothing is gone for good: list_trash shows them and restore_card puts one back where it was, until the trash is emptied in Milanote. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.
| Parameter | Type | Description |
|---|---|---|
| board_id * | string | Board ID from list_boards, or the board URL. |
| card_ids * | array | 1 to 50 card IDs from get_board; a sub-board's board_id works too. |
{
"name": "trash_cards",
"title": "Trash cards",
"description": "Move cards or sub-boards to the trash, as the Delete key does. The cards leave the board for everyone who can see it, and a trashed sub-board takes its contents with it. Nothing is gone for good: list_trash shows them and restore_card puts one back where it was, until the trash is emptied in Milanote. By default you confirm each call; you can switch that off for this tool. Waits for the owner's approval.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"card_ids"
],
"properties": {
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
},
"card_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "1 to 50 card IDs from get_board; a sub-board's board_id works too."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Trash cards",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Turn off a board's read-only link; people who had it can no longer open the board. Does what switching off Share, Enable read-only link does. Editors keep their access. publish_board turns the same link back on, so anyone who kept it can open the board again. was_published is false when the board had no link.
| Parameter | Type | Description |
|---|---|---|
| board_id * | string | Board ID from list_boards, or the board URL. |
{
"name": "unpublish_board",
"title": "Unpublish board",
"description": "Turn off a board's read-only link; people who had it can no longer open the board. Does what switching off Share, Enable read-only link does. Editors keep their access. publish_board turns the same link back on, so anyone who kept it can open the board again. was_published is false when the board had no link.",
"inputSchema": {
"type": "object",
"required": [
"board_id"
],
"properties": {
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Unpublish board",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Image card from a PNG, JPEG, GIF or WebP file, added to a board's Unsorted panel. Uploads one image per call, as Upload in Milanote does, and returns its card_id and size. The file goes in as a file argument (a link, an upload or base64), up to 10 MB; the extension of the name follows the real file type. The image_url opens only for people signed in to Milanote who can see the board. On the free plan an image counts toward the 100 cards limit and uploads are limited too. Nobody is notified; move the card to the trash in Milanote to undo it.
| Parameter | Type | Description |
|---|---|---|
| file * | object | PNG, JPEG, GIF or WebP image. Its name is shown on the card, e.g. location-01.jpg. Up to 10 MB, image/png, image/jpeg, image/gif, image/webp. Give exactly one of file_id (from cotlet_upload_file or POST /api/v1/files), url (a public link Cotlet downloads) or base64 (small files only). |
| board_id * | string | Board ID from list_boards, or the board URL. |
{
"name": "upload_image",
"title": "Upload image",
"description": "Image card from a PNG, JPEG, GIF or WebP file, added to a board's Unsorted panel. Uploads one image per call, as Upload in Milanote does, and returns its card_id and size. The file goes in as a file argument (a link, an upload or base64), up to 10 MB; the extension of the name follows the real file type. The image_url opens only for people signed in to Milanote who can see the board. On the free plan an image counts toward the 100 cards limit and uploads are limited too. Nobody is notified; move the card to the trash in Milanote to undo it.",
"inputSchema": {
"type": "object",
"required": [
"board_id",
"file"
],
"properties": {
"file": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Public http(s) link to the file."
},
"name": {
"type": "string",
"description": "File name, e.g. photo.jpg."
},
"base64": {
"type": "string",
"description": "File content, base64, with or without a data: prefix."
},
"file_id": {
"type": "string",
"description": "From cotlet_upload_file or POST /api/v1/files."
},
"content_type": {
"type": "string",
"description": "MIME type, e.g. image/jpeg."
}
},
"description": "PNG, JPEG, GIF or WebP image. Its name is shown on the card, e.g. location-01.jpg. Up to 10 MB, image/png, image/jpeg, image/gif, image/webp. Give exactly one of file_id (from cotlet_upload_file or POST /api/v1/files), url (a public link Cotlet downloads) or base64 (small files only).",
"additionalProperties": false
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Upload image",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}List boards in the user's own Milanote account from ChatGPT, Claude or any AI agent. Returns how to do it in Milanote step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Milanote Cloud Browser. Milanote's official API: Milanote has no public API and no official MCP server (checked 11 Oct 2026).
No parameters.
{
"name": "milanote_list_boards",
"title": "List boards in Milanote",
"description": "List boards in the user's own Milanote account from ChatGPT, Claude or any AI agent. Returns how to do it in Milanote step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Milanote Cloud Browser. Milanote's official API: Milanote has no public API and no official MCP server (checked 11 Oct 2026).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "List boards in Milanote",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Add note in the user's own Milanote account from ChatGPT, Claude or any AI agent. Returns how to do it in Milanote step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Milanote Cloud Browser. Milanote's official API: Milanote has no public API and no official MCP server (checked 11 Oct 2026).
No parameters.
{
"name": "milanote_add_note",
"title": "Add note in Milanote",
"description": "Add note in the user's own Milanote account from ChatGPT, Claude or any AI agent. Returns how to do it in Milanote step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Milanote Cloud Browser. Milanote's official API: Milanote has no public API and no official MCP server (checked 11 Oct 2026).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Add note in Milanote",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Add link in the user's own Milanote account from ChatGPT, Claude or any AI agent. Returns how to do it in Milanote step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Milanote Cloud Browser. Milanote's official API: Milanote has no public API and no official MCP server (checked 11 Oct 2026).
No parameters.
{
"name": "milanote_add_link",
"title": "Add link in Milanote",
"description": "Add link in the user's own Milanote account from ChatGPT, Claude or any AI agent. Returns how to do it in Milanote step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Milanote Cloud Browser. Milanote's official API: Milanote has no public API and no official MCP server (checked 11 Oct 2026).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Add link in Milanote",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Upload image in the user's own Milanote account from ChatGPT, Claude or any AI agent. Returns how to do it in Milanote step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Milanote Cloud Browser. Milanote's official API: Milanote has no public API and no official MCP server (checked 11 Oct 2026).
No parameters.
{
"name": "milanote_upload_image",
"title": "Upload image in Milanote",
"description": "Upload image in the user's own Milanote account from ChatGPT, Claude or any AI agent. Returns how to do it in Milanote step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Milanote Cloud Browser. Milanote's official API: Milanote has no public API and no official MCP server (checked 11 Oct 2026).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Upload image in Milanote",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Move and edit cards in the user's own Milanote account from ChatGPT, Claude or any AI agent. Returns how to do it in Milanote step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Milanote Cloud Browser. Milanote's official API: Milanote has no public API and no official MCP server (checked 11 Oct 2026).
No parameters.
{
"name": "milanote_move_and_edit_cards",
"title": "Move and edit cards in Milanote",
"description": "Move and edit cards in the user's own Milanote account from ChatGPT, Claude or any AI agent. Returns how to do it in Milanote step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Milanote Cloud Browser. Milanote's official API: Milanote has no public API and no official MCP server (checked 11 Oct 2026).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Move and edit cards in Milanote",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Tick off tasks in the user's own Milanote account from ChatGPT, Claude or any AI agent. Returns how to do it in Milanote step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Milanote Cloud Browser. Milanote's official API: Milanote has no public API and no official MCP server (checked 11 Oct 2026).
No parameters.
{
"name": "milanote_tick_off_tasks",
"title": "Tick off tasks in Milanote",
"description": "Tick off tasks in the user's own Milanote account from ChatGPT, Claude or any AI agent. Returns how to do it in Milanote step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Milanote Cloud Browser. Milanote's official API: Milanote has no public API and no official MCP server (checked 11 Oct 2026).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Tick off tasks in Milanote",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Duplicate board in the user's own Milanote account from ChatGPT, Claude or any AI agent. Returns how to do it in Milanote step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Milanote Cloud Browser. Milanote's official API: Milanote has no public API and no official MCP server (checked 11 Oct 2026).
No parameters.
{
"name": "milanote_duplicate_board",
"title": "Duplicate board in Milanote",
"description": "Duplicate board in the user's own Milanote account from ChatGPT, Claude or any AI agent. Returns how to do it in Milanote step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Milanote Cloud Browser. Milanote's official API: Milanote has no public API and no official MCP server (checked 11 Oct 2026).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Duplicate board in Milanote",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Share read-only link in the user's own Milanote account from ChatGPT, Claude or any AI agent. Returns how to do it in Milanote step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Milanote Cloud Browser. Milanote's official API: Milanote has no public API and no official MCP server (checked 11 Oct 2026).
No parameters.
{
"name": "milanote_share_read_only_link",
"title": "Share read-only link in Milanote",
"description": "Share read-only link in the user's own Milanote account from ChatGPT, Claude or any AI agent. Returns how to do it in Milanote step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Milanote Cloud Browser. Milanote's official API: Milanote has no public API and no official MCP server (checked 11 Oct 2026).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Share read-only link in Milanote",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Export board in the user's own Milanote account from ChatGPT, Claude or any AI agent. Returns how to do it in Milanote step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Milanote Cloud Browser. Milanote's official API: Milanote has no public API and no official MCP server (checked 11 Oct 2026).
No parameters.
{
"name": "milanote_export_board",
"title": "Export board in Milanote",
"description": "Export board in the user's own Milanote account from ChatGPT, Claude or any AI agent. Returns how to do it in Milanote step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools in the user's Milanote Cloud Browser. Milanote's official API: Milanote has no public API and no official MCP server (checked 11 Oct 2026).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Export board in Milanote",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Milanote MCP server by Cotlet: connects Milanote to Claude Code, ChatGPT and any AI agent. Cotlet works in the user's own Milanote account through their Cloud Browser, a real Chrome hosted by Cotlet where the user signed in to Milanote themselves; Cotlet does not store their password. The milanote_* tools each return the Milanote steps for one action (screens, buttons, fields) and open nothing: call one, then do the steps with the cotlet_browser_* tools. Each Milanote operation is its own tool and does a job in one call: prefer them. Writes that reach other people wait for the user's approval in the Cotlet console and answer with status pending and a call_id, which cotlet_get_call reports on. Several Milanote accounts: pass `browser` with a name cotlet_apps lists. For what the operations do not cover, the cotlet_browser_* tools work in the same Milanote browser: call cotlet_app_guide first (free) for its screens. Call the browser tools one at a time, never in parallel: wait for each answer. Open the page with cotlet_browser_open, then cotlet_browser_read it once for its text and numbered elements. Act on those numbers with click, type, select and press, or fill_form for several fields at once; each action answers the page after it (the elements and text in view, same numbers), so read again only to see the whole page. cotlet_browser_find finds one thing on a long page; scroll loads lists that grow as you scroll; screenshot shows boards and canvases (click or drag them by x, y); download gets a file; evaluate extracts data with a script. Public pages open without signing in. Signing in for the user is allowed: on a sign-in page or a 2FA prompt, type the email, password and code the user gave you, and ask them for what you lack (Cotlet does not store them). If the user would rather sign in themselves, or a check a step says needs the person, give them one link only, the sign-in link from cotlet_app_guide (it opens their Cloud Browser right on that page), ask them to reply "done", then go on with the task. Ask the user before a step that sends, publishes, deletes or pays. Each answer names its Tab: send that id as `tab` with the next steps, so a step never acts on another tab the user or another client showed meanwhile (it does nothing and answers tab_changed: read the shown tab or switch back). A refusal says how to go on: no_tab, list the tabs, switch to the task's site (or reopen it), read it and use the fresh Tab id and element numbers; no_element, find the control by its label in the page shown, or read again, and fill only the fields not yet filled; script_failed, read the error and the page first, fix an invalid script, never send it unchanged. Close the browser with cotlet_browser_close when done: each started minute of a session uses credits. After each finished task, never in the middle of one, give the result, then offer 2 or 3 next things to do in the app, from the guide's "What to offer next": another read first, then a small change you make only after the user says yes, and an automation when a job repeats. If you cannot finish the task in the browser (an element you cannot find, a page that will not work, a flow you do not understand) or a step keeps failing, call cotlet_report_issue with what the user asked, the page, the step and what you saw. cotlet_whoami names the account and its credits, cotlet_apps whether the app is ready. When a Cotlet answer starts with a note that your Cotlet tool list is old, tell the user first, with its link, and call cotlet_refresh_button if you have it. The account and credits: https://cotlet.dev/app.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "cotlet_report_issue",
"title": "Cotlet: report a bug or a missing feature",
"description": "Sends a report to the Cotlet team: a tool that failed or returned wrong data, an error you could not get past, or a step the browser could not do, with the page, the step and what you saw. A missing dedicated tool is not a problem to report: do the task in the browser. A feature the user asks for goes as feature_request. A report promises nothing: tell the user it was sent, never that something will be built or fixed, or when. The report carries the error text and call_id when there is one, never passwords or tokens. Needs the user's Cotlet API key or sign-in.",
"inputSchema": {
"type": "object",
"title": "AgentReportCreate",
"required": [
"kind",
"title",
"description"
],
"properties": {
"app": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
],
"title": "App",
"default": null,
"description": "App slug the report is about, e.g. 'skool', or for a site in the web browser its host, e.g. 'app.example.com'."
},
"kind": {
"enum": [
"bug",
"error",
"feature_request",
"missing_feature",
"other"
],
"type": "string",
"title": "Kind",
"description": "bug: a tool did the wrong thing or returned wrong data. error: a call failed or returned an error you could not get past. feature_request: something new the user asked for. missing_feature: a step the task needed that you tried and could not do, in the browser or with a tool. other: anything else."
},
"tool": {
"anyOf": [
{
"type": "string",
"maxLength": 160
},
{
"type": "null"
}
],
"title": "Tool",
"default": null,
"description": "Tool or endpoint name, e.g. 'skool_list_members'."
},
"title": {
"type": "string",
"title": "Title",
"maxLength": 200,
"minLength": 3,
"description": "One line, e.g. 'skool_list_members stops after 50 members'."
},
"client": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
],
"title": "Client",
"default": null,
"description": "Agent or tool sending this, e.g. 'Claude Code'."
},
"call_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"title": "Call Id",
"default": null,
"description": "call_id of the call that went wrong, if any."
},
"description": {
"type": "string",
"title": "Description",
"maxLength": 5000,
"minLength": 10,
"description": "What the user asked for, what you tried, what you expected and what happened, with the error text if there was one. No passwords, tokens or other secrets."
}
},
"description": "Body of POST /api/v1/reports and the arguments of the MCP tool cotlet_report_issue.",
"additionalProperties": false
},
"annotations": {
"title": "Cotlet: report a bug or a missing feature",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}{
"name": "cotlet_browser_click",
"title": "Click on the page",
"description": "Clicks element `element`, or point `x`, `y` of the screenshot; `double` double-clicks, `button: right` right-clicks. Answers the page after it: the elements and text in view, with the same numbers. Says when nothing changed. A link that would open a new tab opens in this one. Buttons that pay or buy, and sign-in and account pages, are refused.",
"inputSchema": {
"type": "object",
"properties": {
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
},
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"button": {
"enum": [
"left",
"right"
],
"type": "string",
"description": "right opens the page's own context menu. Default: left."
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"double": {
"type": "boolean",
"description": "Double-click."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number from the last read or step answer."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Click on the page",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| Text for a prompt dialog this step opens; implies accept. |
{
"name": "cotlet_browser_type",
"title": "Type on the page",
"description": "Types `text` into field `element`, replacing what it held; `submit` presses Enter after it. For several fields use fill_form. Without `element` the text goes where the focus is, as a person types after clicking: for spreadsheet cells and editors that read does not number (Google Sheets, Docs), click the place first; there a tab in `text` presses Tab and a line break Enter, so one call fills a table. Answers the page after it: the elements and text in view, with the same numbers. A password or code the user gave you goes in like any text; card fields are refused.",
"inputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"tab": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The Tab id of the last answer. The step acts only while that tab is the shown one; if the user or another client showed another tab, it does nothing and answers tab_changed. Leave it out to act on the shown tab."
},
"text": {
"type": "string",
"maxLength": 5000,
"description": "The text to type."
},
"dialog": {
"enum": [
"accept",
"dismiss"
],
"type": "string",
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"slowly": {
"type": "boolean",
"description": "Key by key, for a search or address field whose suggestions do not appear."
},
"submit": {
"type": "boolean",
"description": "Press Enter after typing, e.g. to search."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "The field's number from the last read. Leave it out to type where the focus is."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Type on the page",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}