OneNote
Index and search Microsoft OneNote notebooks in Risotto
Connect your Microsoft OneNote notebooks to Risotto to make all your notes searchable through the AI assistant.
Key Characteristics
| Feature | OneNote | SharePoint |
|---|---|---|
| Authentication | OAuth (user login) | API credentials |
| Setup Location | Settings > Integrations > OneNote | Settings > Integrations > SharePoint |
| Indexes per Org | One | Multiple |
| Scope | All user's notebooks | Specific site/folder |
Prerequisites
Before connecting OneNote, ensure:
- Microsoft Account - You have a Microsoft 365 account with OneNote access
- Admin Access - You are an administrator in your Risotto organization
- Notebook Access - Your Microsoft account can access the notebooks you want to index
Step 1: Connect OneNote
In your Risotto dashboard, go to Settings > Integrations.
Click the OneNote card. Find the Notebook access card ("Reads the notebooks the connected Microsoft account can open.").
Start OAuth Flow
Click the Connect button. You'll be redirected to Microsoft's login page.
Sign In and Authorize
- Sign in with your Microsoft 365 account 2. Review the permissions Risotto is requesting: - Read all OneNote notebooks - Access to your notebooks and pages - Read SharePoint sites - Access to notebooks stored in SharePoint - Maintain access - Keep the connection active for background indexing 3. Click Accept to grant permissions
Verify Connection
After authorization, Risotto opens the OneNote settings page and shows the message OneNote connected. The OneNote card shows:
- Tenant ID: Your Microsoft tenant identifier
- A Connected menu that holds Disconnect...
Step 2: Create a OneNote Index
Open the Knowledge tab
On Settings > Integrations > OneNote, open the Knowledge tab and click Index notebooks. The button shows only after you connect OneNote, and only while your organization has no OneNote index. The Index notebooks dialog opens.
Configure Index
OneNote has no source fields. The dialog says "Agents answer from every notebook the connected Microsoft account can open." Enter the fields:
Field Required Description Name Yes Descriptive name (e.g., "Company Knowledge Base"), up to 100 characters Department Org Admins and Managers: No. Others: Yes Restrict access to a specific department Audience No Everyone (the default) or Assistant only Click Index notebooks to start indexing.
Create index on Knowledge > Indexes works the same way: OneNote appears in its Data source list only after you complete the OAuth connection, and only while your organization has no OneNote index. It is the only place to set Profile filters.
What Gets Indexed
Once created, Risotto indexes:
- All OneNote notebooks your connected account can access
- All sections within those notebooks
- All pages within those sections
Content is converted from OneNote's HTML format to searchable text.
Monitoring Progress
After creating the index, its card on the Knowledge tab reads Indexing, with the number of pages so far. On Knowledge > Indexes, the Indexing Jobs panel above the table shows the same job while it runs:
- A progress bar captioned with the pages processed so far and the pages found (for example,
OneNote 'IT Notebooks' - 120/340 pages processed), and the percentage complete - If the job fails, the caption shows the error, and a retry button appears next to the bar
When the job finishes, it leaves the panel, and the Count column of your OneNote index shows the pages indexed.
Managing Your Connection
Reconnecting After Expiration
Microsoft OAuth tokens expire periodically. When this happens:
- The Notebook access card on the OneNote integration page (Settings > Integrations > OneNote) shows a Connection expired alert: "Reconnect to resume indexing. Paused jobs resume on their own."
- Click Reconnect on the card
- Sign in with Microsoft again
- Grant permissions
Disconnecting OneNote
To remove the OneNote connection:
- Go to Settings > Integrations
- Click the OneNote card
- On the Notebook access card, click the Connected menu, then click Disconnect...
This will:
- Remove the OAuth connection
- Prevent new indexing
- Existing indexed content remains searchable until you delete the index
Reindexing Content
To refresh your indexed content with the latest OneNote changes:
- Go to Knowledge > Indexes
- Find your OneNote index
- Click the row's ⋮ menu (Index actions), then click Reindex
Reindexing will:
- Fetch all current notebooks and pages
- Update content that has changed
- Add new pages created since last index
- Remove pages that no longer exist
Access Control
Department Restriction
Restrict who can search the OneNote index:
- When creating or editing the index, select a Department
- Only members of that department will see results from this index
Organization-Wide Access
Select "Organization-wide (no department restriction)" to allow all users to search the OneNote content.
Troubleshooting
OneNote not available in Data Source dropdown
Cause: OneNote OAuth connection not established or expired.
Solution:
- Go to Settings > Integrations
- Connect or reconnect OneNote
- Return to create index
Connection expired alert
Cause: Microsoft OAuth refresh token has expired (typically after extended inactivity).
Solution:
- Click Reconnect on the OneNote integration page
- Sign in with Microsoft
- Paused jobs will automatically resume
Unable to connect to OneNote
Cause: Microsoft OAuth flow failed.
Solutions:
- Ensure you're using a valid Microsoft 365 account
- Check that your account has OneNote access
- Try using an incognito/private browser window
- Clear browser cookies and try again
No pages indexed
Cause: The connected account may not have access to any notebooks.
Solutions:
- Verify the Microsoft account has OneNote notebooks
- Check that notebooks are not in a restricted location
- Ensure notebooks have pages with content
Only one OneNote index allowed
Cause: Risotto limits OneNote to one index per organization.
Solution:
- Delete the existing OneNote index if you need to recreate it
- Or reindex the existing index to refresh content
Permissions Explained
When you connect OneNote, you grant these Microsoft permissions:
| Permission | Purpose |
|---|---|
Notes.Read.All | Read all OneNote notebooks you have access to |
Sites.Read.All | Access notebooks stored in SharePoint sites |
offline_access | Allow Risotto to refresh access without re-login |
Security Considerations
Token Storage
- OAuth tokens are encrypted at rest
- Refresh tokens are stored securely and never exposed
- Tokens are isolated per organization
Data Access
- Risotto only reads OneNote content - no write access
- Indexed content is stored within your Risotto instance
- Access respects your configured department restrictions
Token Health Monitoring
- Risotto automatically monitors OAuth token health
- Administrators are notified when reconnection is needed
- No manual intervention required for routine token refresh
Limits
| Limit | Value |
|---|---|
| OneNote indexes per organization | 1 |
| Maximum pages per index | 10,000 |
| Token refresh | Automatic |
| Re-authentication frequency | When refresh token expires (~90 days of inactivity) |
Next Steps
After setting up your OneNote index:
- Test the integration using Knowledge > Playground
- Ask Risotto questions about your indexed notes in Slack
- Monitor answer quality and adjust if needed
- Set up regular reindexing to keep content current
For additional help, contact support at support@tryrisotto.com.
Something wrong or missing? Report an issue · View as Markdown