SpeakNotesSpeakNotes
Get Started

SpeakNotes API documentation

The SpeakNotes API turns audio, video, YouTube links, and documents into transcripts and structured summaries, and reads and writes the notes behind them. This page is the endpoint list; the developer platform has the quickstart, authentication, OAuth, errors, and pricing.

Base URL

Every SpeakNotes API request goes to a single host over HTTPS.

https://api.speaknotes.io

Authentication

Send a SpeakNotes API key as a bearer token, an OAuth 2.1 access token, or a Firebase ID token from a signed-in session. Only the discovery routes, GET /v1 and GET /v1/health, work without a credential.

Authorization: Bearer YOUR_API_KEY

Create and revoke keys in Settings, API keys. Any signed-in account can create one, on any plan. Keys beginning sn_test_ run against the free sandbox.

Endpoints

Uploads run in the background: create the upload, send the file, complete it, then poll the note status. Transcription, summarization, and YouTube summaries answer inline.

  • GET/v1Describe the API
  • GET/v1/healthCheck the API is up
  • GET/v1/notesList notes
  • POST/v1/notesCreate a note from text
  • GET/v1/notes/{id}Get a note
  • PATCH/v1/notes/{id}Update a note
  • DELETE/v1/notes/{id}Delete a note
  • GET/v1/notes/{id}/statusGet processing status
  • GET/v1/notes/{id}/transcriptGet a transcript
  • POST/v1/notes/{id}/questionsAsk a question about a note
  • GET/v1/foldersList folders
  • POST/v1/foldersCreate a folder
  • GET/v1/folders/{id}Get a folder
  • PATCH/v1/folders/{id}Rename a folder
  • DELETE/v1/folders/{id}Delete a folder
  • POST/v1/uploadsStart a media upload
  • POST/v1/uploads/{id}/completeFinish an upload and start processing
  • POST/v1/transcriptionsTranscribe audio from a URL
  • POST/v1/summariesSummarize text
  • POST/v1/youtube-summariesSummarize a YouTube video
  • GET/v1/usageGet credit balance and usage

MCP server

SpeakNotes runs a Model Context Protocol server over Streamable HTTP, with thirteen tools covering the same read and write operations. Clients authenticate with an API key or through OAuth; initialize and tools/list work without a credential.

https://api.speaknotes.io/mcp

Developer resources