Docs
How to use Notedge
A practical guide to saving sources, asking questions, organizing projects, and keeping your library portable.
Open NotedgeWhat Notedge does
Notedge is a personal AI knowledge library. Save a source once, keep the original context, get a summary and key points, then ask questions later when you need the exact answer.
- YouTube videos become transcript-backed cards with timestamped answers.
- Documents, PDFs, articles, X posts, links, and notes live beside each other in one searchable library.
- Every card keeps source context, generated notes, and your own notes together.
Save content
Use New capture from the app sidebar. Pick the source type, paste a URL or upload a document, and Notedge creates a card in your library.
- YouTube: paste a public YouTube URL. Private, members-only, and unavailable videos are not supported.
- Documents: upload PDF, DOCX, XLSX, TXT, or Markdown files.
- Links and notes: save articles, X posts, web pages, or standalone notes.
Ask your saved knowledge
Use Ask on a card for source-specific questions, or Library Chat to search across saved cards. Answers are grounded in saved content and show citations or timestamps when available.
- For YouTube cards, timestamp chips jump back to the cited moment.
- For documents, section citations point back to the relevant extracted section.
- For web and note cards, Ask uses the saved source text and card context instead of guessing from the open internet.
Organize with projects
Projects are lightweight folders for grouping cards. Moving a card changes its project metadata without changing the saved file path.
- Use Move from card actions to put a card into a project.
- A card can belong to one project or stay in No project.
- Project scope is available in Library Chat when you want narrower answers.
Connect AI apps with MCP (Plus and Pro)
Notedge runs a remote MCP (Model Context Protocol) server, so the AI apps you use can search, read and ask your library and, if you allow it, save and organize cards. Connecting AI apps is included on Plus and Pro. What an app does through MCP counts toward the same monthly limits as the Notedge app.
- Server URL: https://api.notedge.app/api/v1/mcp (also shown in Settings, under Connect AI apps).
- Sign in with OAuth when the app supports it, or use a personal access token.
- Connected apps cannot delete cards. Deleting a card is only available in the Notedge web app.
Connect Claude, ChatGPT, Claude Desktop and Cursor
Apps that support OAuth open a Notedge sign-in and consent screen the first time they connect. Approve it with the account whose library the app should use.
- Claude.ai and Claude Desktop: add a custom connector, paste the server URL, then sign in to Notedge and approve access.
- ChatGPT: where your plan supports custom connectors, create one with the server URL and OAuth authentication, then sign in to Notedge and approve.
- Claude Code: run claude mcp add --transport http notedge https://api.notedge.app/api/v1/mcp, then complete the sign-in.
- Cursor: add the server URL to your MCP settings (mcp.json) under a name such as notedge, then sign in when Cursor connects.
Use a personal access token
For apps without OAuth sign-in, create a token in Settings, under Connect AI apps. Choose read only or read and write, and an expiry of 30 days, 90 days or none. The token is shown once, so copy it straight away.
- Send it as an HTTP header: Authorization: Bearer <your token>. Cursor and similar apps accept this in the headers of the server entry.
- Codex: add the server to config.toml with bearer_token_env_var pointing at an environment variable that holds your token.
- Grok (xAI API): pass your token as the authorization value of the remote MCP tool.
Read only or read and write
Read only lets an app search, read and ask your library. Read and write also lets it save and organize cards. An app gets read and write only when it asks for it and you approve it on the consent screen; an app that asks for nothing specific gets read only.
- Read only tools: search_library, get_card, list_projects, list_tags, suggest_projects, ask_library, list_conversations, get_conversation.
- Read and write adds: save_url, create_note, update_card, move_card, create_project, rename_project, delete_project, retry_card, reprocess_card, attach_from_url, upload_document, add_attachment.
- upload_document and add_attachment give the app a one-time upload URL, valid for 15 minutes, for the file.
Revoke an app or token
Open Settings, find Connected apps under Connect AI apps, and choose Revoke next to the app or token. It stops working immediately, and the app has to connect again to regain access.
- Moving to the Free plan pauses every connected app until you upgrade again.
Back up your library
Settings includes a full library backup. The backup downloads your active cards as portable Markdown with a manifest and original uploaded files where available.
Delete cards
Delete permanently removes a card, including its saved file and notes. Export important material before deleting because permanent delete is not a recycle bin.
Current beta limits
- PDF uploads: up to 20 MB or 50 pages.
- DOCX, TXT, and Markdown uploads: up to 20 MB.
- XLSX uploads: up to 10 MB, with large spreadsheets reduced into readable sheet sections.
- For launch, upload only files you trust and have permission to process. Notedge blocks macro-enabled Office files and does not execute uploaded files.
- AI-heavy usage is subject to fair-use review while Notedge is in early production.