RemNote MCP Server
# RemNote MCP server for ChatGPT and Claude
RemNote has an official MCP server in its desktop app, reachable by desktop clients on the same computer, according to the live Cotlet.dev page checked 20 November 2026. Cotlet.dev provides a remote MCP server for ChatGPT, Claude and other AI agents to work in your signed-in RemNote web account through browser tools. Ask your agent to find notes, draft flashcards and organize documents, with approval before changes.
## What you can ask
> List the RemNote documents I edited this week.
> Find everything I wrote about mitochondria this term.
> Which documents did I add this month that have no flashcards yet?
> Draft flashcards from my Biology lecture notes. Add nothing until I approve.
> Add today's reading list to my daily document after I approve.
> List my Chemistry notes and propose a folder organization before moving anything.
## Connect in 2 minutes
Get your API key at https://cotlet.dev/app and export it as `COTLET_API_KEY`.
### ChatGPT
Plugins > Add > Add custom MCP server. Use `https://cotlet.dev/mcp/v1/connect` with OAuth.
### Claude
Connectors > Add > Add custom connector. Use `https://cotlet.dev/mcp/v1/connect`.
### Claude Code
```bash
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
```
### Cursor
Copy `.cursor/mcp.json` from this repo into your project:
```json
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": {
"Authorization": "Bearer ${COTLET_API_KEY}"
}
}
}
}
```
## Run it locally (stdio)
This repo is a real MCP server. It speaks MCP over stdio, lists its RemNote tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.
Clone this repository and run `python3 remnote_agent.py serve` with `COTLET_API_KEY` set.
Or with Docker:
```bash
docker build -t remnote-mcp .
docker run -i --rm -e COTLET_API_KEY remnote-mcp
```
The local server exposes seven browser helper tools that access the remote browser connection described on the live page.
Local tools: `remnote_guide`, `remnote_status`, `remnote_open`, `remnote_read`, `remnote_click`, `remnote_type`, `remnote_close`. Without `COTLET_API_KEY` a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".
## Command line
Python 3.10+, nothing else to install. Run from this repo:
```bash
export COTLET_API_KEY="your-key"
python3 remnote_agent.py connect # ready config for Claude Code, Cursor, ChatGPT
python3 remnote_agent.py status # is RemNote ready in your Cotlet.dev account
python3 remnote_agent.py guide # RemNote screens and sign-in link
python3 remnote_agent.py read # open RemNote, read the page, close the browser
python3 remnote_agent.py tools # list Cotlet.dev tools
python3 remnote_agent.py serve # start the stdio MCP server (same as no argument)
```
## Questions from RemNote users
**Does RemNote have an official MCP server?**
Yes. The live page, checked 20 November 2026, describes an official MCP server built into the desktop app. Desktop MCP clients on the same computer can reach it; web clients such as chatgpt.com and claude.ai cannot.
**How does Cotlet.dev connect?**
Cotlet.dev provides a remote MCP server with browser tools. Your agent reads the RemNote guide and works in your own signed-in RemNote web account.
**What can my agent do?**
Search documents, draft flashcards from notes and organize documents. Ask it to obtain your approval before adding or deleting flashcards or moving documents. Flashcard review remains yours to do.
**Which account do I need?**
Use your own RemNote login in the Cotlet Cloud Browser. Enter any sign-in code yourself and connect your AI client to Cotlet.
**Is Cotlet affiliated with RemNote?**
No. Cotlet.dev is independent and is not affiliated with RemNote.
## Live integration
[RemNote tools and connection guide](https://cotlet.dev/integrations/remnote-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=remnote)
---
More: https://cotlet.dev/integrations/remnote-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=remnote
Start free: https://cotlet.dev/signup?app=remnote&utm_source=github&utm_medium=readme&utm_campaign=remnote
TDQS
Scored across 7 tools
Each tool maps to a clearly distinct action or state: guide/status for setup, open/read/close for browser lifecycle, and click/type for page interaction. There is no meaningful overlap between reading the page and mutating it via click/type.
All tool names use the same remnote_ prefix and snake_case, making them easy to scan and group. The only minor inconsistency is that guide and status are noun-like states while the rest are action verbs, so it is not a strict verb_noun pattern throughout.
Seven tools are well-scoped for a browser-automation wrapper: setup, open, inspect, interact, and close. There are no redundant tools and the count is not so small that essential operations are missing.
The set covers the core lifecycle: guide/status, open, read, click/type, and close for working in RemNote through the Cloud Browser. Minor gaps include no explicit wait, reload, back, or screenshot tool, though agents can likely work around these using page elements.