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/mcp

Most 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: podcasts

Available 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.