Milanote visual planning for creatives MCP server: list boards, add note, add link, upload image.
MCP Server: dev.cotlet/milanote
The Model Context Protocol (MCP) server dev.cotlet/milanote exposes Milanote workspace content, specifically boards, notes, and links. It is described as providing access to “Boards, notes and links in your Milanote workspace,” enabling external clients to retrieve that information through MCP.
🛠️ Key Features
Boards in a Milanote workspace
Notes in a Milanote workspace
Links in a Milanote workspace
🚀 Use Cases
Access and read Milanote boards from an MCP-capable client
Retrieve notes associated with a Milanote workspace
Collect or view links stored in Milanote
⚡ Developer Benefits
Clear mapping of workspace entities: boards, notes, and links
Provides structured access to Milanote content for developer integrations
⚠️ Limitations
Available details do not specify supported operations beyond accessing boards, notes, and links
No tool count, capabilities list, or additional technical constraints were provided
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 and its credit balance. Free. Needs the user's Cotlet API key or sign-in.
The apps of the user's workspace and whether each works now: access granted or requested, 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.
Parameters1
app
string
optional
Only this app, e.g. skool.
Raw schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "Only this app, e.g. skool."
}
},
"additionalProperties": false
}
cotlet_request_apps
Requests access to apps for the user's workspace, as Request access in the console: every app is granted at once. An app with dedicated tools gets them after the user signs in to it in their Cloud Browser; any other works now in the user's Web browser with cotlet_app_guide, and the Cotlet team builds its dedicated tools on demand. Takes app slugs as listed at https://cotlet.dev/api/v1/apps. Free. Needs the user's Cotlet API key or sign-in.
Parameters2
apps
array
required
App slugs, e.g. ["skool", "substack"].
use_case
string
optional
What the user wants the agent to do in these apps, in their words.
Raw schema
{
"type": "object",
"properties": {
"apps": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"maxItems": 10,
"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."
}
},
"required": [
"apps"
],
"additionalProperties": false
}
cotlet_get_call
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.
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 works once. Free. Needs the user's Cotlet API key or sign-in.
Sends a report straight to the Cotlet team: a tool that failed or returned wrong data, an error you could not get past, or a tool, field or app the task needed and Cotlet lacks. 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.
Parameters7
kind
string
required
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 wants. missing_feature: an app is here but lacks a tool, field or option the task needed. other: anything else.
title
string
required
One line, e.g. 'skool_list_members stops after 50 members'.
description
string
required
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.
app
any
optional
App slug the report is about, e.g. 'skool', or for a site in the web browser its host, e.g. 'app.example.com'.
tool
any
optional
Tool or endpoint name, e.g. 'skool_list_members'.
call_id
any
optional
call_id of the call that went wrong, if any.
client
any
optional
Agent or tool sending this, e.g. 'Claude Code'.
Raw schema
{
"type": "object",
"properties": {
"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 wants. missing_feature: an app is here but lacks a tool, field or option the task needed. other: anything else.",
"enum": [
"bug",
"error",
"feature_request",
"missing_feature",
"other"
],
"title": "Kind",
"type": "string"
},
"title": {
"description": "One line, e.g. 'skool_list_members stops after 50 members'.",
"maxLength": 200,
"minLength": 3,
"title": "Title",
"type": "string"
},
"description": {
"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.",
"maxLength": 5000,
"minLength": 10,
"title": "Description",
"type": "string"
},
"app": {
"anyOf": [
{
"maxLength": 80,
"type": "string"
},
{
"type": "null"
}
],
"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'.",
"title": "App"
},
"tool": {
"anyOf": [
{
"maxLength": 160,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Tool or endpoint name, e.g. 'skool_list_members'.",
"title": "Tool"
},
"call_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "call_id of the call that went wrong, if any.",
"title": "Call Id"
},
"client": {
"anyOf": [
{
"maxLength": 80,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Agent or tool sending this, e.g. 'Claude Code'.",
"title": "Client"
}
},
"required": [
"kind",
"title",
"description"
],
"additionalProperties": false,
"description": "Body of POST /api/v1/reports and the arguments of the MCP tool cotlet_report_issue.",
"title": "AgentReportCreate"
}
cotlet_browser_open
Wakes the user's Milanote Cloud Browser, a real Chrome hosted on Cotlet and signed in to Milanote as the user. Use it for what the Milanote tools do not cover. Opens `url` when given and returns the page's URL, title and tab. In the web browser `url` opens in the open tab of the same site, else in a new tab when the shown tab already has a site open (at the tab limit in the tab you opened and used longest ago), so the user's other apps stay as they are (the tabs tool lists them). The user watches every step live. Before the first step in an app, Cotlet's app guide says which browser to use and how to work in the app. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters1
url
string
optional
A public http or https address, e.g. https://example.com. In an app's browser, a page of that app.
Raw schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "A public http or https address, e.g. https://example.com. In an app's browser, a page of that app."
}
},
"additionalProperties": false
}
cotlet_browser_navigate
Opens a public http or https address in the user's Milanote Cloud Browser and returns the URL and title it ended on. Only Milanote pages open. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters1
url
string
required
A public http or https address, e.g. https://example.com. In an app's browser, a page of that app.
Raw schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "A public http or https address, e.g. https://example.com. In an app's browser, a page of that app."
}
},
"required": [
"url"
],
"additionalProperties": false
}
cotlet_browser_read
Returns the current page of the user's Milanote Cloud Browser: its readable text, up to 20,000 characters, and a numbered list of its links, buttons, fields, options and toggles, also inside frames. Open dialogs and cookie banners come first: they cover the page, so close or answer them first. Field values, cookies and storage are never returned. On a page longer than that, both start near where it is scrolled to; `element` reads only the part inside that element (a dialog, a form, a list). Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters1
element
integer
optional
Read only inside this element of the last read.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "Read only inside this element of the last read."
}
},
"additionalProperties": false
}
cotlet_browser_screenshot
Returns a JPEG image of the visible part of the current page in the user's Milanote Cloud Browser, with its URL and title: boards, canvases and layouts that the page text does not show. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Scrolls the current page in the user's Milanote Cloud Browser with the mouse wheel, as a person does: down or up by `screens` viewport heights (default 0.8), to the top or the bottom, or until element `element` is in view. Content that loads on scroll appears, and the next read lists it. Returns the URL, title and scroll position (at_top, at_bottom). Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters4
direction
string
optional
Where to scroll. Default: down.
screens
number
optional
How far, in viewport heights, for down and up. Default: 0.8.
element
integer
optional
Scroll until this element of the element list is in view.
inside
integer
optional
Scroll inside this element (a list in a dialog or a side panel), not the page.
Raw schema
{
"type": "object",
"properties": {
"direction": {
"type": "string",
"enum": [
"down",
"up",
"top",
"bottom"
],
"description": "Where to scroll. Default: down."
},
"screens": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 10,
"description": "How far, in viewport heights, for down and up. Default: 0.8."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "Scroll until this element of the element list is in view."
},
"inside": {
"type": "integer",
"minimum": 1,
"description": "Scroll inside this element (a list in a dialog or a side panel), not the page."
}
},
"additionalProperties": false
}
cotlet_browser_click
Clicks a link, button, option or other element of the current page in the user's Milanote Cloud Browser, by its number in the page's element list, or a point of the screenshot (`x`, `y`) for boards, canvases and maps. Returns the URL and title after the click, and says when nothing on the page changed. It acts as the user on that site. Buttons that pay or buy and buttons on account or sign-in pages are refused. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters6
element
integer
optional
The element's number in the element list of the current page.
x
number
optional
Instead of `element`: pixels from the left of the screenshot (boards, canvases, maps).
y
number
optional
With `x`: pixels from the top of the screenshot.
double
boolean
optional
Double-click.
dialog
string
optional
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
optional
Text for a prompt dialog this step opens; implies accept.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot (boards, canvases, maps)."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
},
"double": {
"type": "boolean",
"description": "Double-click."
},
"dialog": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"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
}
cotlet_browser_type
Types text into a field of the current page in the user's Milanote Cloud Browser, by the field's number in the page's element list, and with `submit` presses Enter. Returns the URL and title after it. Password, card and one-time code fields and sign-in pages are refused: the user fills those in themselves. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters6
element
integer
required
The element's number in the element list of the current page.
text
string
required
The text to type.
submit
boolean
optional
Press Enter after typing, e.g. to search.
slowly
boolean
optional
Type key by key: for a search or address field whose suggestions do not appear. Read after it; the suggestions are listed as options to click.
dialog
string
optional
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
optional
Text for a prompt dialog this step opens; implies accept.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"text": {
"type": "string",
"maxLength": 5000,
"description": "The text to type."
},
"submit": {
"type": "boolean",
"description": "Press Enter after typing, e.g. to search."
},
"slowly": {
"type": "boolean",
"description": "Type key by key: for a search or address field whose suggestions do not appear. Read after it; the suggestions are listed as options to click."
},
"dialog": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"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."
}
},
"required": [
"element",
"text"
],
"additionalProperties": false
}
cotlet_browser_select
Chooses an option of a drop-down list on the current page in the user's Milanote Cloud Browser, by the list's number in the element list and the option's label as read lists it (or its value). Returns the URL and title after it. Card fields and account pages are refused. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters4
element
integer
required
The element's number in the element list of the current page.
option
string
required
The option.
dialog
string
optional
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
optional
Text for a prompt dialog this step opens; implies accept.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"option": {
"type": "string",
"maxLength": 300,
"description": "The option."
},
"dialog": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"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."
}
},
"required": [
"element",
"option"
],
"additionalProperties": false
}
cotlet_browser_press
Presses a key on the current page in the user's Milanote Cloud Browser, on the element that has focus: Tab to the next field, Enter to send, Escape to close a dialog or pop-up, arrows to move through a suggestion list or a slider, or one character (a site's shortcut). Returns the URL and title after it, and says when nothing changed. Enter on account pages and characters into password fields are refused. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters4
key
string
required
One of Enter, Tab, Shift+Tab, Escape, Backspace, Delete, Space, ArrowDown, ArrowUp, ArrowLeft, ArrowRight, PageDown, PageUp, Home, End, or a single character such as a or 5.
repeat
integer
optional
Press it this many times, e.g. ArrowDown 3 times. Default 1.
dialog
string
optional
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
optional
Text for a prompt dialog this step opens; implies accept.
Raw schema
{
"type": "object",
"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 a single character such as a or 5."
},
"repeat": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"description": "Press it this many times, e.g. ArrowDown 3 times. Default 1."
},
"dialog": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"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."
}
},
"required": [
"key"
],
"additionalProperties": false
}
cotlet_browser_upload
Puts files into a file field of the current page in the user's Milanote Cloud Browser, or into the file picker that an upload button opens, by its number in the element list. A file is given as {"url": "https://..."} for a file online or {"file_id": "..."} for one uploaded to Cotlet first; up to 10 files, 20 MB each. Returns the URL and title after it. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters2
element
integer
required
The element's number in the element list of the current page.
files
array
required
The files.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"files": {
"type": "array",
"minItems": 1,
"maxItems": 10,
"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
},
"description": "The files."
}
},
"required": [
"element",
"files"
],
"additionalProperties": false
}
cotlet_browser_back
Goes back one page in the user's Milanote Cloud Browser, like the browser's Back button (with `forward`, forward again). Returns the URL and title. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters3
forward
boolean
optional
Go forward instead of back.
dialog
string
optional
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
optional
Text for a prompt dialog this step opens; implies accept.
Raw schema
{
"type": "object",
"properties": {
"forward": {
"type": "boolean",
"description": "Go forward instead of back."
},
"dialog": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"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
}
cotlet_browser_hover
Rests the pointer on an element of the current page (or a point of the screenshot) in the user's Milanote Cloud Browser, as a person does to open a hover menu, a tooltip or a card's preview. Read after it for what opened. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters3
element
integer
optional
The element's number in the element list of the current page.
x
number
optional
Instead of `element`: pixels from the left of the screenshot (boards, canvases, maps).
y
number
optional
With `x`: pixels from the top of the screenshot.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot (boards, canvases, maps)."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
}
},
"additionalProperties": false
}
cotlet_browser_drag
Drags from one element or point of the screenshot to another in the user's Milanote Cloud Browser: a piece on a board, a card between columns, a field into a form builder, a slider's handle. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters4
from
object
required
An element number, or x and y of the screenshot.
to
object
required
An element number, or x and y of the screenshot.
dialog
string
optional
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
optional
Text for a prompt dialog this step opens; implies accept.
Raw schema
{
"type": "object",
"properties": {
"from": {
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot (boards, canvases, maps)."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
}
},
"additionalProperties": false,
"description": "An element number, or x and y of the screenshot."
},
"to": {
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot (boards, canvases, maps)."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
}
},
"additionalProperties": false,
"description": "An element number, or x and y of the screenshot."
},
"dialog": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"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."
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
}
cotlet_browser_wait
Waits until `text` shows on the current page in the user's Milanote Cloud Browser (at most `seconds`, default 5, up to 20), or just `seconds` without text: for results, prices or a page that load slowly. Says whether the text appeared. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Ends the session in the user's Milanote Cloud Browser: the browser keeps its cookies, goes to sleep and the per-minute charge stops. Returns the session's minutes and credits.
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.
Parameters2
app
string
optional
The app's name or Cotlet slug. Default: Milanote.
task
string
optional
What the user wants done in the app, in their words.
Raw schema
{
"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
}
export_board
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.
Parameters2
format
string
required
markdown, plain_text, word, pdf or png.
board_id
string
required
Board ID from list_boards, or the board URL.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id",
"format"
],
"additionalProperties": false
}
get_board
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.
Parameters2
board_id
string
required
Board ID from list_boards, or the board URL.
include_comments
boolean
optional
Also return comment threads with their comments. Default: false.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id"
],
"additionalProperties": false
}
get_sharing
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.
Parameters1
board_id
string
required
Board ID from list_boards, or the board URL.
Raw schema
{
"type": "object",
"properties": {
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"required": [
"board_id"
],
"additionalProperties": false
}
get_usage
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.
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.
Parameters2
limit
integer
optional
1 to 200. Default: 50.
parent_board_id
string
optional
Only boards inside this board (ID or board URL). Default: the boards on your Home.
Raw schema
{
"type": "object",
"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."
}
},
"required": [],
"additionalProperties": false
}
list_labels
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.
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.
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.
Parameters3
done
boolean
optional
true only done tasks, false only open ones. Default: both.
limit
integer
optional
1 to 500 tasks. Default: 200.
board_ids
array
optional
Boards to read (IDs or board URLs), with the boards inside them. Default: Home.
Raw schema
{
"type": "object",
"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."
}
},
"required": [],
"additionalProperties": false
}
list_trash
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.
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.
Parameters2
sort
string
optional
last_viewed or last_modified. Default: last_viewed.
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.
Parameters2
title
string
required
Column title.
board_id
string
required
Board ID from list_boards, or the board URL.
Raw schema
{
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Column title."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"required": [
"board_id",
"title"
],
"additionalProperties": false
}
add_comment
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.
Parameters3
text
string
required
Comment text, plain.
board_id
string
required
Board ID from list_boards, or the board URL.
reply_to_id
string
optional
A comment thread ID or comment ID from get_board (include_comments) to reply in. Default: a new comment card.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id",
"text"
],
"additionalProperties": false
}
add_label
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.
Parameters3
label
string
required
Label name; a name you have not used yet creates the label.
card_id
string
required
Card ID from get_board.
board_id
string
required
Board ID from list_boards, or the board URL.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id",
"card_id",
"label"
],
"additionalProperties": false
}
add_link
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.
Parameters2
url
string
required
Web address to save, starting with http:// or https://.
board_id
string
required
Board ID from list_boards, or the board URL.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id",
"url"
],
"additionalProperties": false
}
add_note
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.
Parameters2
text
string
required
Note text. Each line becomes a paragraph.
board_id
string
required
Board ID from list_boards, or the board URL.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id",
"text"
],
"additionalProperties": false
}
add_notes
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.
Parameters3
notes
array
required
1 to 15 note texts, in order. Each line of a text becomes a paragraph.
board_id
string
required
Board ID from list_boards, or the board URL.
column_id
string
optional
Column on the board (from get_board) to put the notes in, at the top. Default: the board's Unsorted panel.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id",
"notes"
],
"additionalProperties": false
}
add_task
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.
Parameters3
tasks
array
required
1 to 50 tasks, added in order at the end of the list.
card_id
string
required
To-do list ID from get_board.
board_id
string
required
Board ID from list_boards, or the board URL.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id",
"card_id",
"tasks"
],
"additionalProperties": false
}
add_todo_list
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.
Parameters3
tasks
array
required
1 to 50 tasks, in order.
title
string
optional
List title. Default: no title.
board_id
string
required
Board ID from list_boards, or the board URL.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id",
"tasks"
],
"additionalProperties": false
}
create_board
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.
Parameters2
title
string
required
Board title.
parent_board_id
string
optional
Board to nest it in (ID or board URL). Default: your Home.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"title"
],
"additionalProperties": false
}
delete_comment
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.
Parameters2
board_id
string
required
Board ID from list_boards, or the board URL.
comment_id
string
required
comment_id from get_board (include_comments) or add_comment.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id",
"comment_id"
],
"additionalProperties": false
}
duplicate_board
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.
Parameters3
title
string
optional
Title of the copy. Default: the same title.
board_id
string
required
Board to copy: ID or board URL.
parent_board_id
string
optional
Board to put the copy in (ID or board URL). Default: where the original is.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id"
],
"additionalProperties": false
}
edit_comment
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.
Parameters3
text
string
required
New comment text, plain.
board_id
string
required
Board ID from list_boards, or the board URL.
comment_id
string
required
comment_id from get_board (include_comments) or add_comment.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id",
"comment_id",
"text"
],
"additionalProperties": false
}
edit_note
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.
Parameters3
text
string
required
New note text. Each line becomes a paragraph.
card_id
string
required
Note ID from get_board.
board_id
string
required
Board ID from list_boards, or the board URL.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id",
"card_id",
"text"
],
"additionalProperties": false
}
invite_editor
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.
Parameters2
email
string
required
Their email address.
board_id
string
required
Board ID from list_boards, or the board URL.
Raw schema
{
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "Their email address."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"required": [
"board_id",
"email"
],
"additionalProperties": false
}
move_card
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.
Parameters4
card_id
string
required
Card ID from get_board; a sub-board's board_id works too.
board_id
string
required
Board the card is on now: ID or board URL.
to_board_id
string
optional
Board to move it to. Default: the same board.
to_column_id
string
optional
Column on the target board to put it in, at the top. Default: no column.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id",
"card_id"
],
"additionalProperties": false
}
publish_board
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.
Parameters3
board_id
string
required
Board ID from list_boards, or the board URL.
allow_comments
boolean
optional
Let viewers of the link comment, react and draw. Default false.
allow_downloads
boolean
optional
Show download links on files to viewers. Default true.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id"
],
"additionalProperties": false
}
remove_editor
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.
Parameters3
email
string
optional
Their email address, instead of user_id.
user_id
string
optional
Their user_id from get_sharing or invite_editor.
board_id
string
required
Board ID from list_boards, or the board URL.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id"
],
"additionalProperties": false
}
rename_board
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.
Parameters2
title
string
required
New title.
board_id
string
required
Board ID from list_boards, or the board URL.
Raw schema
{
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "New title."
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"required": [
"board_id",
"title"
],
"additionalProperties": false
}
restore_card
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.
Parameters1
card_id
string
required
ID of a trashed card or board from list_trash.
Raw schema
{
"type": "object",
"properties": {
"card_id": {
"type": "string",
"description": "ID of a trashed card or board from list_trash."
}
},
"required": [
"card_id"
],
"additionalProperties": false
}
set_card_color
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.
Parameters3
color
string
required
Colour, or none to clear it.
card_id
string
required
Card ID from get_board: a note, to-do list, link, file or column.
board_id
string
required
Board ID from list_boards, or the board URL.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id",
"card_id",
"color"
],
"additionalProperties": false
}
set_due_date
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.
Parameters5
task
string
required
The task's task_id from get_board, or its exact text.
card_id
string
required
To-do list ID from get_board.
board_id
string
required
Board ID from list_boards, or the board URL.
due_date
string | null
required
YYYY-MM-DD. null or an empty string removes the due date.
due_time
string
optional
HH:MM, 24-hour, with due_date. Default: no time.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id",
"card_id",
"task",
"due_date"
],
"additionalProperties": false
}
set_task_done
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.
Parameters4
done
boolean
optional
true ticks it, false unticks it. Default true.
task
string
required
The task's task_id from get_board, or its exact text.
card_id
string
required
To-do list ID from get_board.
board_id
string
required
Board ID from list_boards, or the board URL.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id",
"card_id",
"task"
],
"additionalProperties": false
}
trash_cards
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.
Parameters2
board_id
string
required
Board ID from list_boards, or the board URL.
card_ids
array
required
1 to 50 card IDs from get_board; a sub-board's board_id works too.
Raw schema
{
"type": "object",
"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."
}
},
"required": [
"board_id",
"card_ids"
],
"additionalProperties": false
}
unpublish_board
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.
Parameters1
board_id
string
required
Board ID from list_boards, or the board URL.
Raw schema
{
"type": "object",
"properties": {
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"required": [
"board_id"
],
"additionalProperties": false
}
upload_image
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.
Parameters2
file
object
required
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
required
Board ID from list_boards, or the board URL.
Raw schema
{
"type": "object",
"properties": {
"file": {
"type": "object",
"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).",
"properties": {
"file_id": {
"type": "string",
"description": "From cotlet_upload_file or POST /api/v1/files."
},
"url": {
"type": "string",
"description": "Public http(s) link to the file."
},
"base64": {
"type": "string",
"description": "File content, base64, with or without a data: prefix."
},
"name": {
"type": "string",
"description": "File name, e.g. photo.jpg."
},
"content_type": {
"type": "string",
"description": "MIME type, e.g. image/jpeg."
}
},
"additionalProperties": false
},
"board_id": {
"type": "string",
"description": "Board ID from list_boards, or the board URL."
}
},
"required": [
"board_id",
"file"
],
"additionalProperties": false
}
Milanote API and MCP server: connect Milanote to ChatGPT and Claude
Yes, ChatGPT, Claude and other AI agents can work in your Milanote account. That includes Cursor, Codex, OpenClaw and any MCP client, plus automations in n8n, Make and Zapier. Ask in plain words, and the AI adds notes, links and to-do lists to your boards, finds what you saved, sorts cards into columns and exports boards to Markdown. It shows you what it will do first and sends nothing to other people until you say so.
As of November 2026, this repo is the missing piece: 30 Milanote tools for AI assistants and scripts.
What you can ask
Put these 12 reference links on the Moodboard sub-board of Brand refresh and skip the ones already there.
Export my Novel outline board and each chapter sub-board as Markdown into ./outline.
Here are my call notes. Add the action items as a to-do list on Q1 campaign with the dates we agreed.
Where did I save that note about the color palette?
A Milanote API and a Milanote MCP server you run on your own computer, in Python, on the session of your own Google Chrome. 30 of the 31 Milanote tools we run in production at Cotlet: boards, notes, links, to-do lists with due dates, columns, labels, trash, comments, sharing and export.
Milanote has no public API and no official MCP server. This repo gives you both:
MCP server for Claude Code, Claude Desktop, Cursor, Codex and any MCP client, over stdio or HTTP. Setup
REST API on http://127.0.0.1:8787/api/v1/milanote, with OpenAPI docs at /docs. Setup
Python: call("get_board", board_id="1XiqwC1Mir4d4N"), plus 9 ready scripts in examples/.
Free for your own use, your own business included (license).
Does Milanote have an API?
No. Milanote has no public API, no webhooks and no official MCP server (checked October 2026). A public API and an MCP server are open requests on its public roadmap, and the only way to get content out is the Export button, one board at a time. This repo and Cotlet give you 30 Milanote tools as a REST API and an MCP server.
Can I get a Milanote API key?
Not from Milanote for your own account. With Cotlet you get your own API key that works with your Milanote account, for scripts, n8n, Make, Zapier or any HTTP client. This repo needs no key: it runs on your computer, on your own Milanote session.
Is there an official ChatGPT integration for Milanote?
No. Milanote has no official ChatGPT or Claude connector, and a public API is still an open request on its roadmap. Cotlet is an unofficial one that works today, in the ChatGPT and Claude apps and in any AI agent that takes an MCP server.
How do I connect Milanote to ChatGPT?
Sign up at cotlet.dev, sign in to Milanote once in your Cloud Browser there, and add Cotlet to ChatGPT, following the steps in your account. Then ask ChatGPT about your Milanote like you would ask an assistant. ChatGPT needs a server on the internet, so this repo alone, running on your computer, does not connect to ChatGPT.
Can ChatGPT add notes and to-dos to my Milanote boards?
Yes, with Cotlet. Paste your call notes or links, and it adds them to the right board as notes, links or a to-do list with due dates, and skips what is already there.
Can I search or export my Milanote boards with AI?
Yes, with Cotlet. Ask where you saved something, or export a board and its sub-boards as Markdown, for example into Notion or a document.
Can I automate Milanote with Zapier, Make or n8n?
Milanote has no Zapier or Make app. With Cotlet, n8n, Make and Zapier can add notes, links and to-dos to your boards, for example from a form, an email or Slack.
Can I use it from my phone?
Yes, with Cotlet: once it is set up, the ChatGPT and Claude apps on your phone can use Milanote for you.
Do I need to be technical?
For Cotlet, no: you sign in to Milanote and add Cotlet to ChatGPT or Claude, with step-by-step instructions in your account. This repo is for people who are fine with Python and a terminal.
Is my Milanote account safe?
Yes. Neither Cotlet nor this repo sees or stores your Milanote password. You sign in yourself, the way you always do, and the AI works on that signed-in session. Anything that reaches other people asks for your OK first: in Cotlet by default, here through your MCP client.
Is it free?
This repo is free, also in your own business. Cotlet is free for 7 days with no card, then one-time credit packs from $29, no subscription. Pricing.
I manage Milanote for several accounts or clients. Does that work?
Yes, with Cotlet. Each Milanote login gets its own connection. Write to contact@cotlet.dev and tell us how many accounts you manage.
How it works
text
AI agent (MCP) / script (REST, Python) ──▶ milanote-mcp on your computer ──your Milanote cookies──▶ milanote.com
▲
milanote-mcp connect ───────┘ reads them once from your Chrome (DevTools Protocol)
You sign in to Milanote in your own Chrome, the way you always do.
milanote-mcp connect attaches to that Chrome through the Chrome DevTools Protocol, reads the milanote.com cookies and your browser's time zone, and saves them to ~/.config/milanote-api-mcp/session.json, readable by your user only. It never sees or stores your password.
Reads are requests to the JSON endpoints of the Milanote web app on app.milanote.com/api. Changes go over the same socket.io channel the web app uses, sent as plain HTTP polling. Everything goes out with your cookies through curl_cffi, which copies Chrome's TLS fingerprint. No headless browser runs.
Milanote's session cookie lasts about a month. When Milanote signs you out, the server reads the cookies from Chrome again, if Chrome is open with remote debugging on.
Requirements
Python 3.11 or newer.
Google Chrome 144 or newer, signed in to Milanote. Any Chrome or Chromium works with a debugging port.
macOS, Linux or Windows.
Any Milanote plan. A free account stops at 100 cards, and the tools say so when Milanote refuses. Changing a board someone shared with you needs edit access to it.
With uv: uv venv && uv pip install -e ., then uv run milanote-mcp ....
Setting it up with an AI agent (Claude Code, Codex, Cursor)? Open it in this folder and ask it to set up the repo: AGENTS.md tells it every step, and it asks you only for the steps in Chrome.
To update: uv tool upgrade milanote-api-mcp (or pip install -U milanote-api-mcp), from source git pull && pip install -e .. We copy every change of the hosted Milanote tools into this repo.
Connect your Chrome
Option A: your everyday Chrome (recommended)
Open chrome://inspect/#remote-debugging in Chrome and switch remote debugging on. Chrome then accepts DevTools connections from programs on this computer, and asks you before each one.
Chrome asks whether to allow the connection. Click Allow.
text
Saved 8 Milanote cookies to /Users/you/.config/milanote-api-mcp/session.json
Signed in to Milanote as Ana Lopez
You can switch remote debugging off again afterwards. Leave it on if you want the server to pick up a new session by itself after Milanote signs you out.
connect looks for Chrome's DevToolsActivePort file in the default profile folder. For Chrome Beta, Canary or a custom profile folder, pass --profile-dir "<folder>".
Option B: a Chrome with a debugging port
Chrome does not open a debugging port on your default profile, so start a separate one, sign in to Milanote there once, and connect to it:
--cdp also takes a ws:// DevTools URL, for example of a Chrome on another machine reached over an SSH tunnel.
Option C: paste the cookie by hand
For a server with no Chrome: in Chrome open DevTools on app.milanote.com, Application > Cookies > https://app.milanote.com, copy the value of __Secure-milanote.session_token, then:
bash
milanote-mcp connect --token # paste it, input is hidden# or, without a session file:export MILANOTE_AUTH_TOKEN=...
A pasted token is not refreshed on its own. Paste a new one when Milanote signs you out. Times then come in this machine's time zone.
Check the session at any time:
bash
milanote-mcp status
MCP server
The MCP server lists every tool with its input schema, a description written for agents, and hints: read tools are marked read-only, and tools that comment, invite, publish or trash are marked so your client asks before running them.
Claude Code
bash
claude mcp add milanote -- uvx milanote-api-mcp mcp
# read only:
claude mcp add milanote -- uvx milanote-api-mcp mcp --read-only
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
milanote-mcp serve also serves MCP over streamable HTTP at http://127.0.0.1:8787/mcp, for clients that take a URL:
bash
milanote-mcp serve
claude mcp add --transport http milanote http://127.0.0.1:8787/mcp
Then ask your agent things like:
Put these 12 reference links on the Moodboard sub-board of Brand refresh and skip the ones already there.
Export my Novel outline board and each chapter sub-board as Markdown into ./outline.
Here are my call notes. Add the action items as a to-do list on Q1 campaign with the dates we agreed.
Where did I save that note about the color palette?
REST API
bash
milanote-mcp serve # http://127.0.0.1:8787, MCP at /mcp, docs at /docs
Each tool has its own route under /api/v1/milanote, the same paths as the hosted API at cotlet.dev, so code written against one works with the other. Path parts and the query string are arguments, and a JSON body adds the rest.
bash
curl 'http://127.0.0.1:8787/api/v1/milanote/boards'
curl 'http://127.0.0.1:8787/api/v1/milanote/boards/1XiqwC1Mir4d4N'
curl -X POST http://127.0.0.1:8787/api/v1/milanote/boards/1XiqwC1Mir4d4N/notes \
-H 'Content-Type: application/json' \
-d '{"text": "Kickoff moved to Tuesday."}'
Any tool by name, body as its arguments:
bash
curl -X POST http://127.0.0.1:8787/api/v1/milanote/tools/export_board -d '{"board_id": "1XiqwC1Mir4d4N", "format": "markdown"}'
GET /api/v1/milanote/tools: every tool with its route, input schema and an example answer.
GET /docs: interactive OpenAPI docs, GET /openapi.json the schema, for n8n, Postman or a generated client.
Answers are JSON. Lists that stop early return has_more: true; raise limit to get the rest.
The server listens on 127.0.0.1 only. To reach it from another device of yours, set a token, and every request then needs Authorization: Bearer <token>:
On a schedule, cron on your own computer works while it is on: 0 18 * * 5 cd ~/milanote-api-mcp-server && .venv/bin/python examples/export_boards.py --board 1XiqwC1Mir4d4N --dir ~/backups/milanote.
All 30 tools
board_id is the ID from list_boards, or the board's URL (https://app.milanote.com/1XiqwC1Mir4d4N/...). Cards the tools add land in the board's Unsorted panel, the same place Milanote puts uploads, so they never cover cards on the canvas. milanote-mcp tools prints this list, milanote-mcp tools --json adds the input schemas.
Boards
Tool
Access
REST route
What it does
list_boards
read
GET /boards
Boards inside one board, by default the boards on your Home, with title, ID and link.
list_recent_boards
read
GET /boards/recent
Boards you opened lately, newest first, wherever they sit in your board tree.
search_boards
read
GET /boards/search
Find boards and cards by text across your boards, like the Search icon in Milanote.
get_board
read
GET /boards/{board_id}
Every card on a board: notes, links, images, files, to-do lists, columns and sub-boards.
create_board
write
POST /boards
New board on your Home or nested inside another board.
rename_board
write
PATCH /boards/{board_id}
Change a board's title.
duplicate_board
write
POST /boards/{board_id}/duplicate
Copy a board with everything on it, sub-boards included, as a template.
export_board
read
GET /boards/{board_id}/export
Export a board as Markdown, plain text, Word, PDF or PNG, as the Export menu does.
Cards
Tool
Access
REST route
What it does
add_note
write
POST /boards/{board_id}/notes
Note card with plain text, added to a board's Unsorted panel.
edit_note
write
PATCH /boards/{board_id}/notes/{card_id}
Replace the text of a note card.
add_link
write
POST /boards/{board_id}/links
Link card for a web address, with the page's title and preview, added to Unsorted.
add_todo_list
write
POST /boards/{board_id}/todo-lists
To-do list card with tasks, each with an optional due date and time, added to Unsorted.
set_task_done
write
PUT /boards/{board_id}/cards/{card_id}/tasks/{task}/done
Tick or untick one task in a to-do list.
add_column
write
POST /boards/{board_id}/columns
Empty column on a board, to group cards in a stack.
Arrange cards
Tool
Access
REST route
What it does
move_card
write
POST /boards/{board_id}/cards/{card_id}/move
Move a card or a sub-board to another board, or into or out of a column.
set_card_color
write
PUT /boards/{board_id}/cards/{card_id}/color
Colour the bar on top of a note, to-do list, link, file or column, or clear it.
add_label
write
POST /boards/{board_id}/cards/{card_id}/labels
Put a label on a card, creating the label when the name is new.
list_labels
read
GET /labels
The labels you can put on cards, with name and colour.
Trash
Tool
Access
REST route
What it does
trash_cards
write
POST /boards/{board_id}/cards/trash
Move cards or sub-boards to the trash, as the Delete key does.
list_trash
read
GET /trash
Cards and boards you moved to the trash, with the board each one came from.
restore_card
write
POST /trash/{card_id}/restore
Take a card or board out of the trash and put it back where it was.
Comments
Tool
Access
REST route
What it does
add_comment
write
POST /boards/{board_id}/comments
Comment card on a board, or a reply in a comment thread, posted under your name.
edit_comment
write
PATCH /boards/{board_id}/comments/{comment_id}
Replace the text of a comment you wrote.
delete_comment
write
DELETE /boards/{board_id}/comments/{comment_id}
Delete a comment you wrote, for everyone.
Sharing
Tool
Access
REST route
What it does
get_sharing
read
GET /boards/{board_id}/sharing
Who can open a board: owner, editors and the read-only link with its settings.
invite_editor
write
POST /boards/{board_id}/editors
Invite someone by email to edit a board and the boards inside it.
remove_editor
write
DELETE /boards/{board_id}/editors
Take away someone's access to a board, or cancel an invite they have not accepted.
publish_board
write
POST /boards/{board_id}/publish
Turn on a board's read-only link, which anyone can open without signing up.
unpublish_board
write
DELETE /boards/{board_id}/publish
Turn off a board's read-only link; people who had it can no longer open the board.
Account
Tool
Access
REST route
What it does
get_usage
read
GET /usage
How many cards your account uses against the free plan's limit, by card type.
Not in this version
Tool
Why
upload_image
On the hosted version it takes the image as a link, an upload or base64 through Cotlet's file handling, which this repo does not have yet. Upload images in Milanote, or use the hosted tool.
Never built, on purpose: your Milanote sign-in, email, password and profile settings, and plans and billing.
Configuration
Variable
Default
What it does
MILANOTE_MCP_HOME
~/.config/milanote-api-mcp
Folder of session.json.
MILANOTE_AUTH_TOKEN
Milanote __Secure-milanote.session_token cookie, instead of milanote-mcp connect.
MILANOTE_PROXY
Proxy for every request to Milanote, e.g. http://user:pass@host:port.
MILANOTE_MCP_READ_ONLY
1 hides and refuses every tool that changes Milanote (same as --read-only).
MILANOTE_MCP_TOKEN
Bearer token required by serve; needed to listen beyond 127.0.0.1.
MILANOTE_MCP_HOST, MILANOTE_MCP_PORT
127.0.0.1, 8787
Address of serve.
Security and your Milanote account
Your password never reaches this code. Only cookies are read, and only those of milanote.com.
The session file is yours.session.json is created with mode 0600. Anyone who has it can act as you on Milanote, so keep it out of git and shared folders.
Local by default.serve binds to 127.0.0.1 and refuses another address without MILANOTE_MCP_TOKEN.
milanote.com only. Requests and redirects outside milanote.com are refused.
Read-only mode.--read-only or MILANOTE_MCP_READ_ONLY=1 exposes the 9 read tools only.
Some actions reach other people. Comments carry your name, invite_editor emails the person you invite, and publish_board makes a board readable by anyone with the link. MCP clients ask before running them; a script does not.
Trash is reversible, comments are not.trash_cards moves cards to the board's trash, and restore_card brings them back. delete_comment deletes for everyone.
Errors
The REST API answers {"error": "<code>", "message": "..."}. The MCP server returns the same code and message as a tool error.
Status
Code
What to do
401
auth_required, auth_expired
No session, or Milanote signed you out. Sign in to Milanote in Chrome and run milanote-mcp connect.
403
scope_denied
The server runs read-only.
403
target_blocked
Milanote refused the request or showed a bot check. Open app.milanote.com in Chrome once, then retry.
422
invalid_input
An argument is missing or wrong; the message names it.
429
rate_limited
Milanote is limiting the account. Wait a few minutes.
502
target_error
Milanote answered with an error, for example the free plan's card limit, or changed its app. git pull for the latest tools, or open an issue.
504
timeout
Milanote did not confirm a change in time. Check the board before you retry, the change may have landed.
your own Cloud Browser in the EU, profile encrypted with AES-256-GCM
When Milanote changes its app
git pull once we have fixed it
fixed for you, every tool tested daily
Approvals
your MCP client asks per call
comments, invites, publishing and trash wait for your OK, switchable per tool
Works with
MCP clients on your machine, local scripts
Claude.ai and ChatGPT connectors, n8n, Make, Zapier, any HTTP client
Who may use it
you and your own business
you, teams, businesses, agencies
Price
free
free 7-day trial with 2,000 credits, no card; then one-time packs from $29 for 5,000 credits
On the hosted version a successful call uses 10 credits for most tools, failed calls are free, and the Cloud Browser uses 50 credits a day while it has an app enabled for agents. Full pricing.
FAQ
Is there a Milanote MCP server for Claude, ChatGPT or Cursor?
Yes, this one runs on your machine: milanote-mcp mcp for Claude Code, Claude Desktop, Cursor and Codex. ChatGPT and Claude.ai connectors need a public HTTPS URL, which the hosted Milanote MCP server gives you.
Can I export Milanote boards to Markdown?
Yes, with sub-boards: python examples/export_boards.py --board <board URL> --dir ./outline writes one Markdown file per board, in folders that follow the nesting. Word, PDF, PNG and plain text work the same way with --format.
Can I back up all my boards?
Run export_boards.py on each board of your Home, from cron. Images and files on a board stay in Milanote. Milanote's own Generate ZIP in the Export menu downloads the originals.
Can it add to boards someone shared with me?
Yes, if your account can edit that board. Read-only boards can be read and exported, not changed.
Does it work on the free plan?
Yes. The free plan's 100-card limit still applies: get_usage shows where you stand, and adding a card past it fails with Milanote's own message.
Why does it need my Chrome?
To read your Milanote session without your password, and your time zone for due dates. Chrome is used once per sign-in, not for each call.
What happens when Milanote signs me out?
Calls fail with auth_expired. With Chrome remote debugging on, the server reads the new cookies on the next call (click Allow when Chrome asks); otherwise run milanote-mcp connect again.
Can it run on a VPS or in Docker?
Technically yes, with MILANOTE_AUTH_TOKEN. Milanote then sees your session from a datacenter IP, which looks less like you. For an always-on setup the hosted version keeps your session in your own Cloud Browser on a fixed IP.
Will my Milanote account get banned?
Requests carry Chrome's fingerprint and go out one at a time, as you would click. Nobody can promise a platform never acts. Keep to your normal use.
Can I use it at work or for my clients?
At work and in your own business, yes, free. You may not offer it to others as a hosted or managed service. For client work, use Cotlet or write to contact@cotlet.dev.
Is it open source?
The source is public under the Elastic License 2.0: free to use and change, also in your own business, but not to resell as a hosted service.
A tool broke or I need another one.Open an issue with the tool name and the error message.
Allowed: using it for yourself and in your own business, free. Changing the code and sharing it under the same license.
Not allowed: offering it to others as a hosted or managed service, removing the license notices, getting around its limits.
Maintained by Cotlet (@cotletdev). Milanote is a trademark of its owner. This project is unofficial and not affiliated with, endorsed or sponsored by Milanote.