Notit MCP connection guide
Before you start
MCP is an open standard that connects AI apps to external data and tools. Connecting Notit lets your AI assistant read the study materials you allow and use them to answer questions. Learn more in the official MCP introduction.
- A Notit account and study materials: Sign in to the account you want to use and check that your courses, lectures, and notes are available in Notit.
- A compatible client: Use an AI app that supports remote HTTP MCP servers and either OAuth sign-in or custom authorization headers. Menu names and access requirements vary by client.
- Your Notit plan: You can connect on any plan, but reading study data through MCP requires Plus or Pro. See Notit plans
Which method should I use? Choose OAuth if your client opens a Notit sign-in page. Follow the manual token steps if it asks you to enter a token or HTTP authorization header.
Connect with OAuth · recommended
Sign in to Notit and approve read permissions. You do not need to issue a manual MCP token or turn on the MCP switch in Notit.
- Open your AI app’s settings for adding a remote MCP server. If a name is required, enter Notit.
- Enter the following server URL and start connecting.
https://mcp.notit.ai/mcp
- When the Notit sign-in page opens, sign in to the account that holds your study materials.
- Review the requesting client and callback host, then select at least one read permission. The permissions table explains what each permission allows.
- Select Connect and return to your AI app. Select or enable Notit tools for your conversation.
Try your first question to check data access. You can find OAuth connections in Notit under Me → Integrations → MCP → Configure → Connected apps.
Connect with a manual token
Use this method with a client that supports custom HTTP authorization headers or a Bearer token.
- In Notit, open Me → Integrations → MCP and turn on the MCP switch. Wait for the token to be issued.
- Open Configure and select at least one required read permission under Token permissions. Changing permissions while MCP is enabled automatically issues a new token.
- Add a remote MCP server in your AI app. Use Copy endpoint in Notit to enter the following address.
https://mcp.notit.ai/mcp
- Use Copy auth header in Notit and enter the copied value in your client’s HTTP authentication settings. If entering it manually, replace the placeholder below with your issued token.
Authorization: Bearer <issued token>
- For separate header name and value fields: use
Authorizationas the name andBearer <issued token>as the value. - For a dedicated Bearer token field: enter only the token, without the
Bearerprefix.
- Save your settings, connect, and send your first question.
Enter your token in the client’s authentication settings, not in an AI conversation. Check the expiry date shown in Notit. Whenever you issue a new token, including after changing permissions, update the credentials saved in your client.
Check the connection and ask a question
Start with “Show me my courses in Notit.” Once your courses appear, choose a course and lecture for your next question.
- Choose a course from your course list.
- Find a lecture by asking something like “Show me the lectures in my Thermodynamics course.”
- Specify the lecture name or date and ask the assistant to read its notes or summarize its transcript.
Replace the example course names and dates with your own. Listing courses and lectures requires their respective read permissions; notes and transcripts also require the corresponding permissions. A server showing “connected” does not by itself confirm access to study data.
Permissions and available data
| Read permission | Available information |
|---|---|
Read coursescourse:read | Your course list, individual course details, and current or upcoming class schedule |
Read lectureslecture:read | Lectures within a course and individual lecture details |
Read notesnote:read | StudyPacks, generated notes, complete Markdown notes, and search within one StudyPack |
Read transcriptstranscript:read | A lecture’s transcript, transcript search, and generated summaries and keywords |
Read exam pointsexam_point:read | Exam points and their source note information, and StudyPack Quick Review |
Notit provides only the tools covered by your approved permissions and checks that the data belongs to your signed-in account. An MCP connection cannot create, edit, or delete Notit data. Search tools work within a specific lecture or StudyPack; they do not search every course at once.
Materials read by the AI are sent to the connected AI service and handled under that service’s data policies. Leave out any read permissions you do not want to grant.
Troubleshooting
Sign-in or authentication failed
Check that the server URL is https://mcp.notit.ai/mcp. If an OAuth approval request has expired, start connecting again from your AI app. For a manual token, check the header name, the space after Bearer , and that you copied the entire token.
My manual token has expired
Check the expiry date in Notit’s MCP settings. Turn MCP off and on again to issue a new token. Review its permissions, save the new credentials in your client, and reconnect.
A tool is missing or I do not have permission
Find the permission you need in the permissions table. For OAuth, disconnect and reconnect with the required permissions. For a manual token, change the token permissions and update your client with the newly issued credentials. Then refresh the connection or tool list in your client.
I connected, but I am asked to upgrade
Connecting and viewing the tool list are available on every plan. Reading study data requires Plus or Pro. Check the plan for the Notit account you connected. After upgrading, try the request again.
My courses or study materials cannot be found
Check that you connected the right account and that the materials appear in Notit. Give the course name and a specific lecture name or date. If notes or transcripts are still being generated, wait for processing to finish and try again. If there is no upcoming class, also check the class schedule saved in Notit.
Disconnect
OAuth connections
In Notit, open Me → Integrations → MCP → Configure → Connected apps and select Disconnect for the app. This stops new data access through that OAuth connection. You can also remove the remaining server configuration from your AI app.
Manual token connections
Remove the Notit MCP server and its saved token or authorization header from your AI app. If you used the same token in several clients, remove it from each one. Do not treat turning off the MCP switch or issuing a new token as immediately revoking an existing token.
OAuth connections and manual tokens are managed separately. Ending one type of connection does not also end the other.
Get help
Visit Notit support or email help@metaplad.com. Include your client, connection method, and error message. Do not send your token.
