Your notes in any MCP app.
CraftNote runs a Model Context Protocol server at mcp.craftnoteapp.com. Add the connector URL to any MCP client — Claude, ChatGPT, Codex, or your own — sign in once, and it can read your notes while you work.
Overview
What is the CraftNote MCP connector?
Model Context Protocol is an open standard that lets AI apps read data from tools you already use. CraftNote exposes a read-only MCP server, so any MCP client can search and read your notes over a secure OAuth connection. You authenticate once with your CraftNote account and can revoke access at any time.
What a connected app can do
Call seven read-only tools: search your notes, read one or several in full, list your folders, list your action items, ask a semantic question across everything, and pull your meeting briefs — all grounded in your own notes, with sources it can cite back.
Read-only by design
The connector exposes a single read scope. A connected app can read your notes, transcripts and summaries, but it cannot create, edit, delete or share anything, and it never sees your raw audio files or account and billing data.
Setup · under a minute
Connect it to your MCP app
You need a CraftNote account and any MCP-capable client. The exact wording differs per app, but the flow is the same everywhere.
Copy the connector URL
Your CraftNote connector lives at mcp.craftnoteapp.com. Copy it — you’ll paste it into your MCP client.
The same URL works for every client: Claude, ChatGPT custom connectors, the Codex CLI, or the MCP Inspector.
Add it as a custom connector
In your MCP client, open its connectors settings and choose “Add custom connector”. Paste the CraftNote URL and continue.
The connector registers itself automatically (Dynamic Client Registration) — there’s no client ID or secret to configure.
Sign in and approve
CraftNote opens its consent screen at app.craftnoteapp.com/oauth/authorize. Sign in with the email you use for CraftNote and approve read-only access. Your client can now read your notes when you ask.
The connection uses OAuth 2.1 with PKCE and short-lived tokens — your password is never shared with the client.
Permissions
What a connected app can and can’t see
Everything below is enforced at the API layer, not just the UI. The consent screen you approve lists it explicitly, in two columns.
What MCP can access
Read-onlyFrom notes you own — plus notes another CraftNote user has shared directly with you.
- Note metadata — title, dates, folder
- Transcript text from your recordings, memos and uploads
- AI summaries, action items and meeting briefs
- Full-text and semantic search across your notes
What MCP can’t access
Out of scope, intentionally.
- No edits or deletes — there are no write endpoints
- No other users’ notes beyond what’s shared with you
- No raw audio or video files — only the transcript and derived content
- No account, billing or subscription data, and no training on your notes
Control
How to disconnect
The reliable way to revoke access is from CraftNote — it deletes the token immediately, and the connected app can no longer read your notes.
From CraftNote
app.craftnoteapp.com → Settings → Connected apps → Disconnect
Deletes the OAuth token instantly. Any in-flight request from the connected app fails and it’s asked to reconnect.
From your MCP client
Its connectors settings → remove CraftNote
Removes the connector from that app. Note this may only clear the app’s own cache — disconnect from CraftNote to be certain the token is revoked.
Troubleshooting
Common questions
Which apps can I connect?
Any MCP client. It’s been used with Claude (web, desktop and the Code CLI), ChatGPT custom connectors and the published ChatGPT app, the Codex CLI, and the MCP Inspector. Because the connector supports Dynamic Client Registration, any client that follows the MCP standard can register itself and connect.
What tools does the connector expose?
Seven read-only tools: search_notes, get_note, get_notes, list_folders, list_action_items, ask_notes (semantic search), and get_meeting_briefs. The client picks the right one based on what you ask — you don’t have to name them.
Can a connected app change my notes?
No. The connector has a single read scope. Apps can read your notes, transcripts, summaries, action items and meeting briefs, but they cannot create, edit, delete or share anything in CraftNote.
Is my password shared with the app?
No. The connection uses OAuth 2.1 with PKCE and short-lived access tokens. You sign in on CraftNote’s own consent screen, and the app only ever receives a scoped, revocable token — never your password.
How do I revoke access?
Go to app.craftnoteapp.com → Settings → Connected apps and disconnect. That deletes the token immediately. Removing the connector inside the client app may only clear its cache, so disconnecting from CraftNote is the reliable way.