Wren MCP authentication and permissions
Sign in once, grant exactly what you intend
A connection that can read and write your notes deserves a clear account of what it can do. This guide explains the Wren MCP sign-in and the permissions you grant, so you can connect with confidence.
If you have not connected yet, start with how to connect Wren to ChatGPT with MCP. This guide assumes you have reached the Wren sign-in step and want to understand it before you approve it.
How the sign-in works
The Wren MCP connection signs in with OAuth 2.1, using PKCE and the S256 challenge method. That is the modern, recommended way for a client to prove it started the sign-in it is completing, without a shared secret travelling through the browser.
In plain terms, the flow is:
- The chat client starts a sign-in and prepares a one-time proof (the PKCE challenge).
- Wren opens a sign-in page where you authenticate with your own account.
- When you approve, Wren returns a credential to the client, and the client uses its one-time proof to redeem it.
Two things matter for your confidence here:
- You sign in on a Wren page, not inside the chat client. Your Wren password never passes through the client.
- You connect as yourself. The connection acts on the same Wren account you signed in with, not a shared or separate one.
What you are granting: the three scopes
When you approve the connection, you grant a specific, named set of scopes. Wren's MCP connection uses three:
notes.read— the client can list your notes and see each note's title, subject and pages. It doesn't see the writing on a page, so it knows where to write, not what you wrote.notes.write— the client can add to and change your notes. This is what lets the chat place something useful on the page, such as a structured list, a formula, or a diagram.profile.read— the client can read basic profile information for your account, enough to know whose notes it is working with.
Those three scopes describe the whole surface. The connection does not ask for anything outside them, and each one maps to an action you can predict: read a note, write a note, or identify the account.

Figure 1. A real Wren 1.5.4 page. Study Buddy proposes an ink graph and waits on an explicit Add to Note. That review step is part of the app; a write from a connected client goes straight into the notebook under the permissions you granted.
Why notes.write is safe to grant
Write access can sound larger than it is. In practice, a write through Wren can only create notes, add pages, write on pages Wren wrote, and rename notes. It never modifies your own handwriting.
There is no draft step, though: a write lands in your notebook as soon as the tool runs. When a connected client adds a graph, a formula, or an explanation, open the page in Wren and check that it answers the question you actually had. A write is not an overwrite of your thinking; your own handwriting stays exactly as you left it.
Scope of the connection, in one view
- Who it acts as: you, through your own Wren account sign-in.
- What it can read: your note titles, subjects and page lists (
notes.read) and basic profile data (profile.read). - What it can change: your notes (
notes.write): new notes and pages, pages Wren wrote, and note titles. Never your own handwriting. - How you approve it: on Wren's own OAuth 2.1 sign-in page, with PKCE S256.
If any of those does not match what a client is asking for, stop and re-check the connection before approving.
A permissions checklist before you approve
- Confirm the sign-in page is Wren's own page, where you enter your account.
- Confirm you recognise the three scopes:
notes.read,notes.write,profile.read. - Approve the sign-in to complete the connection.
- After connecting, list your notes to confirm
notes.readworks. - Add one small item and check it on the page in Wren to confirm
notes.writeworks.
Common questions
Does the connection use a password I type into ChatGPT?
No. You sign in on Wren's OAuth 2.1 page with your own account. The chat client never receives your Wren password; it receives a credential only after you approve the sign-in.
Can a connected client reach another person's notes?
No. You authenticate as yourself, and the scopes apply to your own account. The connection reads and writes your notes under notes.read and notes.write, and identifies the account under profile.read.
What should I do after I connect?
Return to the setup guide to confirm the connection with a real read and write. Then use the review-and-organization guide to turn what a connected client adds into something you can actually study from.
More questions
What sign-in method does the Wren MCP connection use?
OAuth 2.1 with PKCE using the S256 challenge method. You sign in with your own Wren account and never paste a password into the chat client.
What can a connected client do with my notes?
It is limited to the scopes you grant: notes.read, notes.write, and profile.read. It works only on your own account's notes.