Developers
Connect DriftNote to any AI assistant
DriftNote speaks the Model Context Protocol, so assistants that support connectors — Meta Muse, Claude, ChatGPT — can summarize podcasts on your behalf. Ask for a recap of a show and your assistant does the rest.
Connect with MCP
Point your assistant at this endpoint:
https://www.driftnote.net/api/mcpMost assistants handle the rest themselves. DriftNote is an OAuth 2.1 provider with dynamic client registration, so an assistant can register, send you to a consent screen, and hold a token from then on — you never copy a credential. If you don't have a DriftNote account yet you can create one during that flow.
For scripts and anything that can't do OAuth, create an API key on your settings page and send it as Authorization: Bearer dn_live_…. Both credential types work everywhere.
You can see and disconnect every connected assistant from settings at any time.
OAuth endpoints
Discovery is advertised the standard way, so most clients need nothing but the MCP URL above. A 401 from the API carries a WWW-Authenticate header pointing at the resource metadata.
https://www.driftnote.net/.well-known/oauth-authorization-server
https://www.driftnote.net/.well-known/oauth-protected-resource
Authorization: https://www.driftnote.net/oauth/authorize
Token: https://www.driftnote.net/api/oauth/token
Registration: https://www.driftnote.net/api/oauth/register
PKCE (S256) is required. Scope: podcastsAvailable tools
search_podcastsFind shows by name. Returns feed URLs for the other tools.summarize_latest_episodeSummarize a show's newest episode from a feed URL or just its name.summarize_episodeSummarize one episode from a Spotify, Apple, YouTube, RSS or audio link.get_summaryPoll for a summary by id while it's processing.list_summariesList recent summaries.ask_about_episodeAsk a follow-up question about an episode (Pro).share_summaryPublish a summary and get a public link.follow_podcastAuto-summarize a show's new episodes as they drop (Pro).
Or use the REST API
The same capabilities are available over plain HTTP. The OpenAPI description lives at /openapi.json and needs no authentication to read.
# Summarize the latest episode of a show
curl -X POST https://www.driftnote.net/api/v1/summarize-latest \
-H "Authorization: Bearer $DRIFTNOTE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "Huberman Lab"}'
# -> {"summaryId": "…", "status": "processing", "episodeTitle": "…"}
# Poll until it's done (2-5 minutes is typical)
curl "https://www.driftnote.net/api/v1/summaries?id=SUMMARY_ID" \
-H "Authorization: Bearer $DRIFTNOTE_API_KEY"How summarizing works
Transcribing and summarizing a full episode takes time, so the summarize endpoints return a summaryId straight away and keep working in the background. Poll get_summary (or GET /api/v1/summaries?id=…) roughly every 30 seconds — most episodes finish within 2 to 5 minutes.
Limits
Free accounts get 5 summaries a month; Pro is unlimited. Requests are rate limited per key, and each account can have 3 summaries processing at once. Asking follow-up questions and following shows require Pro.
Questions
Send us a message from settings and we'll reply by email.