# Milanote by Cotlet

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2
- Author: cotletdev
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cotletdev/milanote-api-mcp-server
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/milanote-by-cotlet

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://cotlet.dev/mcp/v1/milanote/connect`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http milanote https://cotlet.dev/mcp/v1/milanote/connect
```

2. **Platform CLI**
```bash
claude mcp add milanote-by-cotlet -- uvx milanote-api-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from milanote-api-mcp <command>

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add milanote-by-cotlet --url https://cotlet.dev/mcp/v1/milanote/connect
```

2. **Platform CLI**
```bash
codex mcp add milanote-by-cotlet -- uvx milanote-api-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from milanote-api-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "milanote-by-cotlet": {
            "url": "https://cotlet.dev/mcp/v1/milanote/connect"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "milanote-by-cotlet": {
            "type": "http",
            "url": "https://cotlet.dev/mcp/v1/milanote/connect"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http milanote-by-cotlet https://cotlet.dev/mcp/v1/milanote/connect
```

2. **Platform CLI**
```bash
gemini mcp add milanote-by-cotlet uvx milanote-api-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from milanote-api-mcp <command>

## When to use it
- 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
- 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.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md