Commentarii Roamani

Hello Roamans! This edition is the second issue of a multi-part series on Roam MCP. We will look at more workflows and ways you can expand Roam's capabilities with AI (and AI's capabilities with Roam). Also, WE HAVE MERCH (∩˃o˂∩)♡

This is Part II. If you missed it, check out Part I here.


FIRST, THE MERCH

We have been making MERCH ٩(^ᗜ^ )و ´- See some of our designs below and order here :)))


NOW, THE FLOW

Today we look at a study flow that takes care of the tedious parts of spaced repetition so you don't have to do any busywork, and can focus on learning.

Let's start with the result, what do you get out of this flow?

  • the permanent note
  • the reminder to review
  • the test page
  • the flashcards
  • the calendar booking
  • the email progress report

your pov: Every day, your calendar holds a slot for active recall. When you open Roam, a TODO in your daily note tells you which decks to review (and whether to use Cram Mode). If you got new material that day, you add it to your Drive folder, and by the next morning it’s in your deck. Then you click Review in the sidebar, go through the deck and check off the TODO. If you skip a day, you leave the TODO unchecked, and the AI moves your review to the next day. At the end of the week, an email tells you what worked, what didn’t, and what you still have left to study.


Recall Engine

This flow automates the tedious parts of spaced repetition, like writing and organizing the flash cards, but remove the need to remember what and when to review.

Tools

  • Roam
  • Claude or ChatGPT
  • Google Connectors: Drive, Gmail and Google Calendar
  • ​Memo by Jose Browne (a Roam Depot extension)

Setup

This setup is shorter than it looks! We will present it in three rounds.

The first is simply installing and connecting the tools listed in the section above. The second round will be giving out the base instructions to your AI agent (we've prepared the right prompts for you). The third is a regular round you need to do every time you are learning new material or have a new exam.

Then you have no excuse but to review the cards :p
​

ROUND 1: Connections (do this 1x)

1. Connect the Roam MCP to Claude or ChatGPT.

Find Roam under Connectors (in Claude) or Plugins (in ChatGPT) and connect your graph:

During setup, you can add as many databases as you like and give each one a nickname, such as "work" or "personal", so your assistant can tell them apart.

2. Connect Google Drive, Gmail and Google Calendar to Claude or ChatGPT.

3. Install​ Memo by Jose Browne from Roam Depot.

Reminder: To install an extension, go to the left sidebar, and open Roam Depot. Search for the extension and click Install (see all the details in the video below). Each extension comes with a description from its creator.

ROUND 2: Explain the flow to the AI (do this 1x)

After installing everything, you need to set up a few elements:

1. Create a Google Drive folder called: Study Materials. You can make subfolders inside it.

2. Create a new Google calendar called Recall Engine.

3. Create a Claude or ChatGPT project called Recall Engine Agent, and paste this into the project instructions:

4. Open a chat in the project and paste this prompt to create your scheduled tasks:

​

ROUND 3: The flow (for every exam)

Three things you have to do, the rest is taken care by the AI:

1. Start an exam

  • You: ask the AI in your project to set it up, for example “Set up Music Technology Test 1 on November 20th.”
  • The AI: creates the exam page in Roam and a folder for it in Study Materials.
  • You: open the Memo settings in Roam Depot and type the exact name of the exam page in Tag Pages. This creates the deck.

2. Add your material

  • You: after each class, save your slides, files or lecture transcripts in the exam’s folder.
  • The AI: every night, it turns them into Permanent Notes and flashcards in Roam, tagged for your Memo deck.

3. Answer your cards

  • You: when the TODO appears in your daily note, open Memo, pick the deck and answer the cards.Then check off the TODO.
  • The AI: books your review sessions in your calendar, moves unchecked reviews to the next day, and sends you a progress report every week.

​

Prefer to learn in the chat?

If you prefer to learn with your AI first, and turn the conversation into cards after: open a chat in your Recall Engine Agent project and go through the material together (ask questions, examples, have it quiz you, etc...) Then, at the end of the chat, write something like: “Turn what we covered into notes and flashcards for Music Technology/Test 2.” Your project instructions already tell the AI how to do this, so that one sentence is enough. The AI adds the new ideas to your Permanent Notes and writes the cards, tagged for your deck. The next day, they show up in Memo with the rest (don't forget to go into the Memo settings to add a deck if it's new!)

Summary

The whole point of the flow is to make it automatic and seamless. You set it up once, and then you’re good to go. Every time you study, just click Review and pick your deck.

Troubleshooting: if something doesn’t work, check these first:

  • All your files are in the Study Materials folder. If you forgot some, add them and ask the AI in your project to catch up.
  • Type the deck name, like Music Technology/Test 1/Cards, in Tag Pages. Otherwise, Memo won’t find the cards.
  • The scheduled tasks are allowed to run without asking for approval. Otherwise, they stop and wait for you.

Use cases recap

​Part I:

1. Self knowledge from your own journals

2. Supercharged learning and research with RoamxAI

Part II:

3. Recall Engine

Stay tuned for the next workflows! And give us recommendations on our slack or social media


Change Log

Here is what changed in Roam recently!

New features 𓁇𓁋

  • AI now lives inside Roam. It reads your graph and, when you allow it, writes into it. It runs on your own API key from OpenAI, Anthropic, Google, xAI or OpenRouter (Settings > AI)
    • Chat with your graph opens with cmd-j (ctrl-j on Windows and Linux). You can ask about your notes, have it search the graph or the web, or give it a change to make
    • Ask AI runs a block as a request: type /Ask AI in a block, and the answer appears beneath it. Your own blocks are never rewritten
    • You choose what it can change in each chat: Read, Manual (it asks before each write) or Auto
    • The page roam/agent guidelines tells the AI how to behave in your whole graph
  • Roam Desk keeps the notes you're working on one shortcut away: opt-shift-s (alt-shift-s on Windows and Linux). You can write new notes or add any block or page, and each note you write is saved on that day's daily note.
  • Sidecar opens a little Roam window over any app on your computer with opt-s (ctrl-alt-s on Windows and Linux). It comes with version 0.0.42 of the desktop app.
  • You can now generate :q queries with AI

We will make more content to showcase the newest developments in the coming newsletters!!!

Roam Depot extensions

There are lots of new extensions in Depot! Go check them out:

  • Inline Autocomplete
  • Roam Publish
  • Pinned Blocks
  • Asyntai AI Chatbot
  • Discovery Superintel
  • Roam Pele
  • Roam Zen
  • Find In Page
  • Roam Drop
  • Vaults
  • Plexus Diagram

Bug fixes 🐜

  • Semantic search now returns results when you pick a small date range
  • Clicking a block in the sidebar no longer jumps to the same block in the main window when both show the same linked references, query, embed or mentions
    ​

⋆.𐙚 ̊۶ৎ Quality of life improvements 𝜗ৎ𐙚⋆

  • Roam Desk and Sidecar got a bunch of improvements:
    • Your cursor comes back where you left it
    • New notes can go on your daily note instead of your Desk page (Settings > Preferences > Desk)
    • New arrows take you to the note above or below, and a button jumps to the top note
    • Option+Shift+N (Alt+Shift+N on Windows and Linux) makes a new Desk note from anywhere
    • Checked off to-dos can leave the Desk on their own (off by default)
    • Sneak peek: more is coming in the next few days! You'll be able to customize your Sidecar hotkeys, jump far through your notes with a new animation, and link a note to a window of another app on macOS, so the Sidecar opens that note when you summon it from that window.
  • Videos uploaded to Roam play in a new player that shows their timestamps.
  • The video player also has a theater mode and a timestamps view.
  • The slash commands now favor matches at the start of a word, so typing "te" finds "template" before "date picker".
  • Roam Mobile got a lot of updates:
    • Linked references now show below the page, and under each day in Daily Notes.
    • You can tap a video timestamp to jump to that moment.
    • YouTube videos play inline, and /Video Timestamp inserts the current time.
    • Tapping a block reference opens a new menu to jump to it, copy it or edit it.
    • The page title appears in the top bar once you scroll past it.
    • The autocomplete menu has icons now, and it keeps its results while you type.

ᯓ✮


​Join our Slack channel here, and don’t forget to check out the Roam help graph for more news from us ♥︎ Until next time, Roamans!
​