Connect your notes to any AI agent
LunaNotes ships a Model Context Protocol (MCP) server. Add it to Claude, ChatGPT, Cursor, or any MCP client, sign in once, and your agent can search your library, read your notes, and save new ones back.
Set it up in a minute
Pick your app and follow the steps. You sign in with your LunaNotes account and choose what the app may do. No API key to copy.
Claude
ChatGPT
Gemini
Copilot
Grok
Mistral
Server URL
https://api.lunanotes.io/mcp - In Claude, open Customize → Connectors.
- Click + and choose Add custom connector.
- Name it LunaNotes, paste the server URL, and click Add.
- Click Connect, sign in to LunaNotes, and approve access.
Works in Claude on the web, desktop, and mobile once added.
- In ChatGPT, open Settings → Apps → Advanced settings and turn on Developer mode.
- Click Create app.
- Name it LunaNotes, paste the server URL, and choose OAuth.
- Sign in to LunaNotes, approve access, then enable the app in a chat.
Developer mode is available on paid ChatGPT plans.
- Run this in your terminal.
- Inside Claude Code, type /mcp, pick lunanotes, and choose Authenticate.
claude mcp add --transport http lunanotes https://api.lunanotes.io/mcp - Click Add to Cursor, then Install.
- Click Connect next to lunanotes and sign in to LunaNotes.
Or add it by hand: Cursor Settings → Tools & MCP → New MCP Server.
- Click Add to VS Code, then Install.
- Start the server and sign in to LunaNotes when VS Code asks.
Or run MCP: Add Server from the command palette, choose HTTP, and paste the URL.
- Add the server.
- Sign in to LunaNotes.
Add
codex mcp add lunanotes --url https://api.lunanotes.io/mcp Sign in
codex mcp login lunanotes - Paste the server URL into your client. If it supports OAuth, it opens LunaNotes to sign in.
- Clients that read a JSON config take this.
{
"mcpServers": {
"lunanotes": {
"type": "http",
"url": "https://api.lunanotes.io/mcp"
}
}
} No OAuth? Create a read-only API key in Settings → AI apps.
What your agent can do
Everything is scoped to your own account, and the app only gets the permissions you approve. Disconnect it anytime from Settings → AI apps.
- Search your library
search_notes - Find notes, videos, bookmarks, and documents by meaning, not just keywords.
- Read and write notes
get_note - Read any note in full, create new ones, edit, tag, or apply a template.
- Import a YouTube video
import_video - Paste a link and LunaNotes pulls the transcript, chapters, and summary.
- Flashcards and diagrams
generate_flashcards - Turn a note or video into a flashcard set or a diagram you can study later.
- Ask your documents
ask_documents - Get answers grounded in your uploaded PDFs and files, with the source.
- Account info
get_me - Check your plan and remaining credits before a long task.
Explore what else LunaNotes does
Each one works on the same notes, so what you make in one feeds the rest.
Make it studyable
Bring it in
- Video workspace Your video library, with notes attached
- Timestamped notes Notes that jump back to the moment
- YouTube extension Notes and transcripts inside YouTube
- YouTube courses Work through a playlist in order
- Bookmarks Save any page, find it again
- Meeting notes An AI notetaker for Google Meet
- Podcasts Subscribe, listen, keep the notes
- Files PDFs, documents and images you upload