dev.cotlet由 cotlet.dev 發布官方發布者v1.0.2更新於 Nov 7, 2026
Boards, notes and links in your Milanote workspace.
發布方自己的服務：Cotlet
非官方的 Milanote MCP 伺服器，讓助理在你自己的帳號中讀取、建立、整理、分享與匯出看板、筆記、連結、待辦清單和留言。
Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/dev.cotlet%2Fmilanote/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。
{
"mcpServers": {
"milanote-by-cotlet": {
"type": "http",
"url": "https://cotlet.dev/mcp/v1/milanote/connect"
}
}
}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.
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?
Cotlet is best for designers, writers and teams who want ChatGPT, Claude or another AI agent to work in Milanote for them, with nothing to install.
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:
http://127.0.0.1:8787/api/v1/milanote, with OpenAPI docs at /docs. Setupcall("get_board", board_id="1XiqwC1Mir4d4N"), plus 9 ready scripts in examples/.Free for your own use, your own business included (license).
[Milanote MCP server] [Python 3.11+] [License: Elastic 2.0] [MCP Badge]
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 [email protected] and tell us how many accounts you manage.
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.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.
From PyPI:
MCP clients can also run it with no install: uvx milanote-api-mcp mcp.
From source:
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.
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.
Make sure you are signed in at app.milanote.com.
Run:
Chrome asks whether to allow the connection. Click Allow.
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>".
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.
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:
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:
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.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
~/.cursor/mcp.json, the same block as Claude Desktop. A ready copy is in mcp.json.
~/.codex/config.toml:
milanote-mcp serve also serves MCP over streamable HTTP at http://127.0.0.1:8787/mcp, for clients that take a URL:
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?
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.
Any tool by name, body as its arguments:
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.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>:
Straight from Python, no server needed:
Or one tool from the shell: milanote-mcp call get_board board_id=1XiqwC1Mir4d4N, or with a JSON object.
Ready scripts in examples/. Each takes --help, and the ones that list things print JSON or save --out file.csv / --out file.json:
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.
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.
Never built, on purpose: your Milanote sign-in, email, password and profile settings, and plans and billing.
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.serve binds to 127.0.0.1 and refuses another address without MILANOTE_MCP_TOKEN.--read-only or MILANOTE_MCP_READ_ONLY=1 exposes the 9 read tools only.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_cards moves cards to the board's trash, and restore_card brings them back. delete_comment deletes for everyone.The REST API answers {"error": "<code>", "message": "..."}. The MCP server returns the same code and message as a tool error.
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.
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 [email protected].
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.
Elastic License 2.0. In short:
Maintained by Cotlet (@cotletdev). Milanote is a trademark of its owner. This project is unofficial and not affiliated with, endorsed or sponsored by Milanote.
來源：README.md，提交 589a97c
Add column
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.
title必填board_id必填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.
text必填board_id必填reply_to_idAdd 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.
label必填card_id必填board_id必填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.
url必填board_id必填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.
text必填board_id必填Add to-do 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.
tasks必填titleboard_id必填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.
title必填parent_board_idDelete 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.
board_id必填comment_id必填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.
titleboard_id必填parent_board_idEdit 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.
text必填board_id必填comment_id必填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.
text必填card_id必填board_id必填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.
format必填board_id必填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.
board_id必填include_commentsGet 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.
board_id必填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.
無需輸入參數。
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.
email必填board_id必填List boards
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.
limitparent_board_idList 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.
無需輸入參數。
List recent boards
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.
limitList 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.
無需輸入參數。
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.
card_id必填board_id必填to_board_idto_column_idPublish 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.
board_id必填allow_commentsallow_downloadsRemove 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.
emailuser_idboard_id必填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.
title必填board_id必填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.
card_id必填Search boards
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.
sortquery必填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.
color必填card_id必填board_id必填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.
donetask必填card_id必填board_id必填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.
board_id必填card_ids必填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.
board_id必填已滿足適用檢查項的 90%
該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。
請在儲存庫或註冊中心條目中宣告授權條款。
dev.cotlet官方發布者
Cotlet 是託管的 MCP 伺服器，讓 AI 助理透過你親自登入的雲端 Chrome 瀏覽器，在沒有可用 API 的應用程式中執行操作。
dev.cotlet官方發布者
將助理連接到 Tradify 行業業務帳戶，用來查詢與建立工單、報價、發票、客戶及排程預約。
dev.cotlet官方發布者
讓助手在你自己的 Substack 帳號中操作：草稿、發佈、Notes、留言、訂閱者、私訊與數據統計。
dev.cotlet官方發布者
讓助手在使用者自己的 Skool 帳號中讀取與管理社群：貼文、成員、入群申請、Classroom、行事曆、聊天與統計。
dev.cotlet官方發布者
非官方的 Pirate Ship 伺服器，可在自己的帳號中查詢 USPS/UPS 運費、建立草稿託運單與批次，並讀取寄件報表。
uv tool install milanote-api-mcp # or: pip install milanote-api-mcpmilanote-mcp connect # reads your Milanote session from Chromemilanote-mcp call list_boardsclaude mcp add milanote -- uvx milanote-api-mcp mcpAI 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)uv tool install milanote-api-mcp # or: pipx install milanote-api-mcp, or: pip install milanote-api-mcpmilanote-mcp --versiongit clone https://github.com/cotletdev/milanote-api-mcp-server.gitcd milanote-api-mcp-serverpython3 -m venv .venv. .venv/bin/activate # Windows: .venv\Scripts\activatepip install -e .milanote-mcp --versionmilanote-mcp connectSaved 8 Milanote cookies to /Users/you/.config/milanote-api-mcp/session.jsonSigned in to Milanote as Ana Lopez# macOS"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --remote-debugging-port=9222 --user-data-dir="$HOME/.chrome-milanote"# Linuxgoogle-chrome --remote-debugging-port=9222 --user-data-dir="$HOME/.chrome-milanote"# Windows"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="%USERPROFILE%\.chrome-milanote"
milanote-mcp connect --cdp http://127.0.0.1:9222milanote-mcp connect --token # paste it, input is hidden# or, without a session file:export MILANOTE_AUTH_TOKEN=...milanote-mcp statusclaude mcp add milanote -- uvx milanote-api-mcp mcp# read only:claude mcp add milanote -- uvx milanote-api-mcp mcp --read-only{ "mcpServers": { "milanote": { "command": "uvx", "args": ["milanote-api-mcp", "mcp"] } }}[mcp_servers.milanote]command = "uvx"args = ["milanote-api-mcp", "mcp"]milanote-mcp serveclaude mcp add --transport http milanote http://127.0.0.1:8787/mcpmilanote-mcp serve # http://127.0.0.1:8787, MCP at /mcp, docs at /docscurl '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."}'curl -X POST http://127.0.0.1:8787/api/v1/milanote/tools/export_board -d '{"board_id": "1XiqwC1Mir4d4N", "format": "markdown"}'MILANOTE_MCP_TOKEN=$(openssl rand -hex 24) milanote-mcp serve --host 0.0.0.0from milanote_api_mcp import call
boards = call("list_boards")["boards"]board = call("get_board", board_id=boards[0]["id"])call( "add_todo_list", board_id=board["board_id"], title="This week", tasks=[{"text": "Send the brief", "due_date": "2026-10-28"}, {"text": "Book the photographer"}],)python examples/export_boards.py --board 1XiqwC1Mir4d4N --dir ./outlinepython examples/save_links.py --board 1XiqwC1Mir4d4N --file links.txt --dry-run