Is the SpeakNotes API free to use?

Every account gets 60 credits a month at no cost, and sandbox keys are unlimited and free forever. Pro accounts get 2,000 credits a month. Beyond the monthly grant you buy prepaid credit packs.

How do I get a SpeakNotes API key?

Sign in and open Settings, API keys. You create the key yourself and it works immediately. There is no application process and no contact form.

Does SpeakNotes have a sandbox environment?

Yes. Any key you create with the sandbox option starts with sn_test_. It exercises every route and returns fixed, realistic output without calling a model, spending credits, or writing to your real notes.

How do I connect SpeakNotes to Claude or another MCP client?

Point the client at https://api.speaknotes.io/mcp over Streamable HTTP. Clients that support OAuth register themselves and prompt you to authorize; clients that do not can send a SpeakNotes API key as a bearer token.

Does the SpeakNotes API support OAuth?

Yes. SpeakNotes runs an OAuth 2.1 authorization server with PKCE, refresh token rotation, dynamic client registration, and revocation. Metadata is published at https://speaknotes.io/.well-known/oauth-authorization-server.

What are the SpeakNotes API rate limits?

120 read requests, 30 write requests, and 10 processing requests per minute, counted per credential. Every response carries the remaining budget in its rate limit headers, and a 429 tells you exactly how long to wait.

Developer platform

The SpeakNotes API, MCP server, and OAuth platform

Turn audio, video, and YouTube links into transcripts and structured summaries from your own code, or let an AI agent do it through MCP. Every account can create a key and start in the sandbox for free.

Create a key yourself in the dashboard. No sales call, no waiting list.
Sandbox keys return fixed output, spend no credits, and never touch your real notes.
A hosted MCP server so Claude, ChatGPT, and Cursor can use SpeakNotes natively.

Create an API key Read the quickstart

Three requests to your first summary

Start with a sandbox key to learn the shapes, then swap in a live key when the responses look right.

1
Create a key
Open Settings, API keys and create one. Choose sandbox to try things out, or live to process real audio.
# Any signed-in account can create one. Sandbox keys start sn_test_. open https://speaknotes.io/settings/api-keys

2

Call the API

Send the key as a bearer token. Summaries, transcriptions, and YouTube jobs answer inline.

curl -X POST https://api.speaknotes.io/v1/summaries \
  -H "Authorization: Bearer $SPEAKNOTES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "...your transcript...", "styleId": "meeting-notes"}'

3

Upload longer media

Uploads run in the background: create the upload, PUT the file, complete it, then poll the note until it is done.

# 1. create the upload
curl -X POST https://api.speaknotes.io/v1/uploads \
  -H "Authorization: Bearer $SPEAKNOTES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fileName": "standup.m4a", "contentType": "audio/mp4"}'

# 2. PUT the file to uploadUrl, then complete it
curl -X POST https://api.speaknotes.io/v1/uploads/NOTE_ID/complete \
  -H "Authorization: Bearer $SPEAKNOTES_API_KEY"

# 3. poll until status is Done
curl https://api.speaknotes.io/v1/notes/NOTE_ID/status \
  -H "Authorization: Bearer $SPEAKNOTES_API_KEY"

What the platform gives you

A REST API that reads and writes

List, create, update, and delete notes and folders. Transcribe audio, summarize text, and summarize YouTube links. Every operation is in the OpenAPI 3.1 spec.

A hosted MCP server

Streamable HTTP at api.speaknotes.io/mcp, with thirteen tools covering the same read and write operations. Agents connect over OAuth or with a key.

OAuth 2.1 with PKCE

Build an app that acts for other SpeakNotes users. Dynamic client registration means an MCP client can register itself and connect without anyone pasting a key.

A real sandbox

Keys that start sn_test_ run every route, validation rule, and response shape against fixed output. No credits, no model calls, and writes land in a separate sandbox library.

Credits you can see

One credit is one started minute of media. Every response that costs something returns what it charged and what is left, so an agent can check before it starts.

Scoped credentials

Give a key or an app only what it needs. A read-only key can list notes and never delete one.

Pricing

Every account gets a monthly grant of credits that resets. Pro accounts get a much larger one. Beyond that, credits are prepaid, so a runaway retry loop can never run up a bill.

60

credits a month on the free plan

2,000

credits a month with Pro

See credit pricing

Reference

Questions developers ask

Is the SpeakNotes API free to use?: Every account gets 60 credits a month at no cost, and sandbox keys are unlimited and free forever. Pro accounts get 2,000 credits a month. Beyond the monthly grant you buy prepaid credit packs.
How do I get a SpeakNotes API key?: Sign in and open Settings, API keys. You create the key yourself and it works immediately. There is no application process and no contact form.
Does SpeakNotes have a sandbox environment?: Yes. Any key you create with the sandbox option starts with sn_test_. It exercises every route and returns fixed, realistic output without calling a model, spending credits, or writing to your real notes.
How do I connect SpeakNotes to Claude or another MCP client?: Point the client at https://api.speaknotes.io/mcp over Streamable HTTP. Clients that support OAuth register themselves and prompt you to authorize; clients that do not can send a SpeakNotes API key as a bearer token.
Does the SpeakNotes API support OAuth?: Yes. SpeakNotes runs an OAuth 2.1 authorization server with PKCE, refresh token rotation, dynamic client registration, and revocation. Metadata is published at https://speaknotes.io/.well-known/oauth-authorization-server.
What are the SpeakNotes API rate limits?: 120 read requests, 30 write requests, and 10 processing requests per minute, counted per credential. Every response carries the remaining budget in its rate limit headers, and a 429 tells you exactly how long to wait.