Skip to main content
Glama
cotletdev

Milanote MCP Server

by cotletdev

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MILANOTE_PROXYNoProxy for every request to Milanote, e.g. http://user:pass@host:port.
MILANOTE_MCP_HOMENoFolder of session.json.~/.config/milanote-api-mcp
MILANOTE_MCP_HOSTNoAddress the `serve` command listens on.127.0.0.1
MILANOTE_MCP_PORTNoPort the `serve` command listens on.8787
MILANOTE_MCP_TOKENNoBearer token required by `serve`; needed to listen beyond 127.0.0.1. Every request then needs Authorization: Bearer <token>.
MILANOTE_AUTH_TOKENNoMilanote __Secure-milanote.session_token cookie, used instead of `milanote-mcp connect`.
MILANOTE_MCP_READ_ONLYNoSet to 1 to hide and refuse every tool that changes Milanote (same as --read-only).

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
add_columnA

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.

add_commentA

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.

add_labelA

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.

add_linkA

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.

add_noteA

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.

add_todo_listA

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.

create_boardA

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.

delete_commentA

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.

duplicate_boardA

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.

edit_commentA

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.

edit_noteA

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.

export_boardA

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.

get_boardA

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.

get_sharingA

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.

get_usageA

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.

invite_editorA

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.

list_boardsA

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.

list_labelsA

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.

list_recent_boardsA

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.

list_trashA

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.

move_cardA

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.

publish_boardA

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.

remove_editorA

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.

rename_boardA

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.

restore_cardA

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.

search_boardsA

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.

set_card_colorA

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.

set_task_doneA

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.

trash_cardsA

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.

unpublish_boardA

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.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.1/5.0

Scored across 30 tools

Disambiguation5/5

Each tool has a distinct resource and action; card-creation tools are separated by card type (note, link, todo list, comment, column), while board navigation, search, trash, sharing, and usage are clearly scoped. There is no meaningful overlap that would cause misselection.

Naming Consistency5/5

All tool names use snake_case and follow a predictable verb_noun pattern (list_boards, add_note, create_board, delete_comment, get_sharing, set_task_done). Minor compound names like set_card_color remain readable and consistent.

Tool Count2/5

At 30 tools, the surface is heavy and exceeds the typical well-scoped range; many granular operations are exposed separately. While the domain is broad, the count feels excessive and could be consolidated.

Completeness3/5

Core board, comment, note, sharing, trash, and export workflows are covered, but notable gaps remain: no tools to add image/file cards, no way to add tasks to an existing to-do list or edit task due dates, and no label removal. These gaps could cause agent dead ends for common board-management requests.

Maintenance

ActivityMaintained
ResponsivenessNo issues