Podbrain Tools reference
Once Podbrain is connected, your agent can call these five tools. You never call them yourself. Ask in plain words and the agent picks the right one. Every result is Markdown with a link back to the episode.
| Tool | Access | What it does |
|---|---|---|
search_episodes | Signed in account | Finds episodes by topic, guest or phrase, optionally inside one show or after a date. |
get_episode_notes | Signed in account | Returns the professional notes for one episode: key takeaways, section by section points with speaker quotes, and every book mentioned. |
get_references | Signed in account | Lists the books and references mentioned in one episode, or across a whole show, with how often each came up and a link to the listing. |
follow_show | Signed in account | Follows a podcast for you, so its new episodes are tracked and noted shortly after release. |
list_follows | Signed in account | Lists the podcasts you follow on Podbrain. |
search_episodes
Finds episodes by topic, guest or phrase, optionally inside one show or after a date. Leave the query out to list a show’s latest episodes.
Access: Signed in account
| Input | Type | Meaning |
|---|---|---|
query | text, optional | Topic, guest name or phrase. At least 2 characters. |
show | text, optional | One show by slug or part of its name, for example huberman. |
since | date, optional | Only episodes published on or after this date, as YYYY-MM-DD. |
sort | relevance or recent | Relevance when there is a query, recent otherwise. |
limit | number, 1 to 25 | How many results. Default 10. |
What has Huberman Lab said about sleep and caffeine?
Found 3 episode(s) for "sleep caffeine", show huberman:
- **Essentials: Sleep Toolkit for Optimizing Sleep & Sleep-Wake Timing** (Huberman Lab · 2026-06-11)
id: huberman-lab/essentials-sleep-toolkit-for-optimizing-sleep-sleep-wake-timing
https://podbrain.app/p/huberman-lab/essentials-sleep-toolkit-...
…Cold exposure for 1-3 minutes paradoxically increases core body temperature…get_episode_notes
Returns the professional notes for one episode: key takeaways, section by section points with speaker quotes, and every book mentioned.
Access: Signed in account
| Input | Type | Meaning |
|---|---|---|
episode | text | The episode id or slug from search_episodes. |
Give me the key takeaways from that sleep toolkit episode.
# Essentials: Sleep Toolkit for Optimizing Sleep & Sleep-Wake Timing
Huberman Lab · 2026-06-11 · Notes: https://podbrain.app/p/huberman-lab/...
## Key takeaways
- ...
## Books and references mentioned
- ...get_references
Lists the books and references mentioned in one episode, or across a whole show, with how often each came up and a link to the listing.
Access: Signed in account
| Input | Type | Meaning |
|---|---|---|
target | text | An episode id or slug, or a show slug or name. |
scope | episode or show | Whether target is an episode or a show. Default episode. |
limit | number, 1 to 50 | Rows for show scope. Default 20. |
Which books does The Tim Ferriss Show mention most?
## References (show: tim ferriss)
- [Book title by Author](https://www.amazon.com/dp/...) · mentioned 3x · in: Episode title
Why it came up in the conversation.follow_show
Follows a podcast for you, so its new episodes are tracked and noted shortly after release.
Access: Signed in account
| Input | Type | Meaning |
|---|---|---|
show | text | The show slug or name. |
Follow Huberman Lab for me on Podbrain.
Now following **Huberman Lab** on Podbrain.list_follows
Lists the podcasts you follow on Podbrain.
Access: Signed in account
No inputs.
Which shows am I following on Podbrain?
Followed shows:
- Huberman Lab (huberman-lab)
- The Tim Ferriss Show (the-tim-ferriss-show)Limits and accounts
- Every tool needs you to sign in to Podbrain from your agent's connector settings. If you are signed out, the agent gets a message asking you to sign in.
- If you are signed in but have no plan yet, the agent gets your personal link to start the free trial. The trial saves a card and charges nothing.
- The trial covers your first 30 episodes. Each distinct episode a tool returns counts once: a search that returns 10 episodes uses 10, and opening one of those again later is free.
- After 30 episodes or 30 days, whichever comes first, the plan continues on Unlimited at $9.99 a month. Cancel anytime.
- The catalogue covers about 170 shows and 2,400 episodes. An empty search means Podbrain does not have that show yet.