Milanote by Cotlet — Claude Code MCP server: setup
Connect an AI agent to Milanote boards to work with notes, links, and tasks. The server runs on your computer and uses a Chrome session.
claude mcp add --transport http milanote https://cotlet.dev/mcp/v1/milanote/connectWhat Milanote by Cotlet does
The server gives an agent tools for viewing and editing Milanote boards, notes, links, task lists, columns, and labels. It also supports comments, trash, sharing, and export. Editing a board shared with you requires edit access.
To connect, milanote-mcp connect reads cookies from your signed-in Google Chrome session and saves them in ~/.config/milanote-api-mcp/session.json. It does not access your password. You need Python 3.11 or later and Chrome signed in to Milanote; if the account session expires, reconnect through the browser.
Claude Code can start the server with uvx, so you do not have to install the package first. The listed clients also include Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, and Gemini CLI. The self-hosted software is licensed for noncommercial use.
What it helps with
- view Milanote boards from an agent chat
- add a note or link to a board
- update a task list with due dates
- find and edit a board column or label
- export board content
Example prompts for the agent
- Show my Milanote boards and open the one I need.
- Add a note with this plan to the project board.
- Update the board's task list and set due dates.
How to install Milanote by Cotlet
1Platform CLI: remote server
claude mcp add --transport http milanote https://cotlet.dev/mcp/v1/milanote/connect2Platform CLI
claude mcp add milanote-by-cotlet -- uvx milanote-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from milanote-api-mcp <command>
1Platform CLI: remote server
codex mcp add milanote-by-cotlet --url https://cotlet.dev/mcp/v1/milanote/connect2Platform CLI
codex mcp add milanote-by-cotlet -- uvx milanote-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from milanote-api-mcp <command>
Config file
{
"mcpServers": {
"milanote-by-cotlet": {
"url": "https://cotlet.dev/mcp/v1/milanote/connect"
}
}
}{
"mcpServers": {
"milanote-by-cotlet": {
"command": "uvx",
"args": [
"milanote-api-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from milanote-api-mcp <command>
Config file
{
"servers": {
"milanote-by-cotlet": {
"type": "http",
"url": "https://cotlet.dev/mcp/v1/milanote/connect"
}
}
}{
"servers": {
"milanote-by-cotlet": {
"type": "stdio",
"command": "uvx",
"args": [
"milanote-api-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from milanote-api-mcp <command>
1Platform CLI: remote server
gemini mcp add -t http milanote-by-cotlet https://cotlet.dev/mcp/v1/milanote/connect2Platform CLI
gemini mcp add milanote-by-cotlet uvx milanote-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from milanote-api-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Milanote by Cotlet
How do I install Milanote by Cotlet in Claude Code?
Add the server with claude mcp add milanote-by-cotlet -- uvx milanote-api-mcp. You also need a Chrome session signed in to Milanote.
What does Milanote by Cotlet do?
It lets an AI agent work with Milanote content, including boards, notes, links, and task lists. It also supports comments, labels, sharing, and export.
What is required to connect to Milanote?
You need Python 3.11 or later and Google Chrome signed in to Milanote. The server reads session cookies from Chrome rather than using your password.
