Bring in your meetings
Connect Granola or Zoom so meeting transcripts arrive in a Space with who said what. Using another tool? Your agent can bring those meetings in for you.
Have your agent do it
Paste this to your agent. It reads this guide and works through it with you.
Read https://avalandra.com/help/bring-in-your-meetings.md and do it with me. Ask me before you decide anything the guide leaves to me, and tell me what you did when you're done.Connect Granola or Zoom once, and new meetings arrive in a Space on their own. Then anyone on the team can ask their agent what was said, without having been on the call.
Decide first
Answer these before you connect anything. Your agent will ask you about them.
- Whose meetings. Your own notes, the team's shared notes, or both. Leave out any accounts or kinds of meeting that shouldn't come in.
- How far back. Everything you can reach, or only meetings from a date onwards.
- Where they land. Pick a private Space for the raw meetings. Raw transcripts often hold more than everyone should read, so they don't go straight into the shared Space.
- Who can read them. Only the people in that Space.
- What gets cleaned out. Before a transcript is shared, your agent takes out private talk such as health, family and money. See Sanitize your transcripts.
A common setup is to bring meetings into your private Space, then have your agent put a cleaned copy of each full transcript into the shared Space for the work.
Connect Granola or Zoom
- Get a key from the meeting tool. In Granola, create an API key (Granola's guide). For Zoom, create a server-to-server app (Zoom's guide). Give it access only to what you decided to bring in.
- Add the connection. Enter the key only in the secret field. Never paste it into a chat, a prompt or a document.
- Choose the destination Space. The connection makes its own folder there and keeps it up to date. Don't move, rename or edit that folder while the connection is on.
- Check the first meeting. Make sure the connection is on, the last import worked, and one meeting you expected has arrived. Open it to see whether you got the full transcript or only notes.
Help me connect my Granola account to Avalandra. Ask me which meetings to bring in, how far back to go and which private Space they should land in. Don't ask for my API key in chat: tell me where to enter it. Then check that the first meeting arrived.Sanitize your transcripts
Meetings wander. A full transcript can include someone's health, a family matter or a pay conversation that was never meant for the whole team. Before a transcript goes into a shared Space, your agent makes a cleaned copy and leaves the original untouched in your private Space.
What your agent takes out, unless you've said a particular meeting needs it:
- health and medical details
- family and relationship matters
- personal money, such as pay, debts or a mortgage
- private career talk, such as job searches or reviews
- staff and HR matters about a named person
- passwords, keys, codes and other credentials
- personal chat unrelated to the work
How the cleaned copy works:
- The rest stays word for word, with each speaker's name and the time, so it still answers "who said what".
- Each removed passage becomes
[private discussion redacted], and nothing else. The placeholder never says what kind of thing was removed, because even "health" tells a reader something. - The original stays where it is. Your agent never edits, moves or deletes the raw transcript; it writes a new document.
- When unsure, it asks you, without quoting the passage in its question. For a meeting that's sensitive as a whole, it asks whether to share it at all.
Make a sanitized copy of the transcript of [the meeting] for the [name of your shared Space] Space. Keep everything word for word with speakers and times, except replace health, family, personal money, private career, staff or HR matters, credentials and unrelated personal chat with [private discussion redacted]. Don't say what kind of thing you removed. Don't change the original. If you're not sure about a passage, ask me without quoting it. Use the template at https://avalandra.com/help/template-files/cleaned-transcript. Name it with the meeting's short name, the word "transcript" and the meeting date, and nothing longer.Next, have your agent do the follow-up. See Follow up after a meeting.
Sanitize every new transcript automatically
New transcripts keep arriving, so you can have your agent clean each one as it comes in. Either way, it skips transcripts that already have a cleaned copy, never touches the original, and holds back any transcript it's unsure about until you answer, so nothing private reaches the shared Space by accident.
- On a schedule. Set a scheduled task in your agent's own tool, such as Claude Code or Codex, to check for new transcripts every hour or so.
- As they arrive. While your agent is running, it can watch your private Space and clean each new transcript within moments of it landing.
From now on, whenever a new meeting transcript arrives in the [name of your private Space] Space, make a sanitized copy in the [name of your shared Space] Space, following https://avalandra.com/help/bring-in-your-meetings.md#sanitize-your-transcripts. Use the template at https://avalandra.com/help/template-files/cleaned-transcript, named with the meeting's short name, the word "transcript" and the meeting date. Check [every hour during working hours, or continuously while you're running]. Skip any transcript that already has a cleaned copy. If you're unsure about a passage, don't publish that transcript; ask me in [where you want questions, such as a Slack direct message] without quoting it, and finish it once I answer. Tell me each time you publish one.Using another meeting tool
If your meetings happen somewhere else, such as Google Meet, Microsoft Teams or a phone call with notes, your agent can bring them in for you. Most meeting tools let you download a transcript or notes. Give that file to your agent, or tell it where your tool saves them if your agent can reach that place. It adds the full transcript to your private Space with a note of where it came from, then makes a sanitized copy for the shared Space, as above.
I use [your meeting tool]. Here's the transcript of [the meeting] from [the date]: [attach it, paste it, or say where it's saved]. Add the full transcript to the [name of your private Space] Space as a document titled with the date, the meeting name and the tool, with a line saying where it came from. Keep the speakers' names and times as they are. Then sanitize it into the [name of your shared Space] Space, following https://avalandra.com/help/bring-in-your-meetings.md#sanitize-your-transcripts.To make it a habit, ask your agent to do this after each meeting, or schedule it in your agent's own tool if it can reach the folder where your transcripts are saved.
Ask about a meeting
What did we decide about [the topic] on [the meeting, such as Tuesday's call with a client]? Tell me who said it, and link me to the transcript.If something's off
- Nothing has arrived. Check that the connection is on and look at its last import. The meeting tool may not have finished processing the meeting yet.
- Only notes, no transcript. Some meetings only have notes or a summary. Your agent works from whatever came in, and should tell you which it had.
- A meeting arrived twice, or changed. The meeting tool can update a meeting after it's sent. The connection updates the same document in Avalandra rather than adding a new one.
Questions
Which meeting tools bring meetings in automatically?
Granola and Zoom. For any other tool, your agent can bring meetings in for you. See Using another meeting tool.
Why did a meeting arrive with notes but no transcript?
Some meetings only have notes or a summary in the meeting tool, and that's what comes in. Your agent works from whatever arrived and should tell you which it had.
Can my agent tidy up the folder where meetings arrive?
Leave that folder as it is while the connection is on. The connection owns the folder and the meetings in it, and keeps them up to date. Ask your agent to put summaries and notes in a different folder.
For agents
ava connector providers --json
ava connector create --file - --idempotency-key KEY
ava connector check ID
ava connector list
ava connector runs ID
ava connector providers --jsonshows what each provider brings in. Granola offersnotesandtranscripts. Zoom offersmeeting_transcript,recording_transcriptandsummary.createtakes JSON withdisplay_name,scope,provider,destination,interval_minutes,sources,share_private,notificationsandcredentials. Send secrets only on stdin (--file -) or from a file, never as flags and never in a document. Reads never return secrets.revise,enable,pause,removeandcredentials replaceneed--expected-revision.- The connection owns the documents it imports. Read them; never edit, move, rename or delete them. A document can be revised by the connection, so detect changes by its revision id.
- Never copy ids from an example or another organization. Read them from the person's own instance.
- To sanitize automatically, either run on a schedule in your host and use
ava changes list --space PRIVATE_SPACE_IDto find transcripts added since your last run, or stay running withava changes watch --space PRIVATE_SPACE_IDand act on each new transcript as it lands. Key each cleaned copy to its source (such asgranola:<transcript-id>orava:<document-id>), check for that key before writing, and never publish a transcript with an unanswered question. - When sanitizing, write a new document and never edit the source. Replace every excluded passage with exactly
[private discussion redacted], and never name the excluded category anywhere, including in questions, comments, logs or the document title. Ask about uncertain passages without quoting them. Before writing, check the destination's readers can all see what you're putting there. - When you bring in a meeting from another tool, first check the destination folder for a document with the same date and meeting name. Create it with
ava document createin the private Space the person named, titled likeYYYY-MM-DD - Meeting name (Tool), with a first line saying where the transcript came from and who provided it. Keep the transcript as given; put your summary in a separate document.