VidNotes Platform — client packages
Public client packages for the VidNotes developer platform. Call VidNotes video intelligence from Claude, Codex, the terminal, or your own code: transcripts, summaries, chapters, multi-video comparisons, and saved notes.
These are thin clients over the hosted VidNotes API (https://api.vidnotes.app).
The backend and apps are closed-source; everything you run locally is in this repo.
Packages
| Package | What it is | Install |
|---|---|---|
@vidnotes/mcp-server | MCP server — 13 tools for any MCP client (Claude, Codex, …) | npx -y @vidnotes/mcp-server |
@vidnotes/cli | Command-line interface for scripts and automation | npm i -g @vidnotes/cli |
@vidnotes/api-client | Typed JavaScript client the CLI and MCP server are built on | npm i @vidnotes/api-client |
Quickstart
Get an account-scoped API key from Settings → CLI, MCP, and API access at
https://app.vidnotes.app/settings, or run vidnotes login.
npm install -g @vidnotes/cli
export VIDNOTES_API_KEY="vnp_..."
vidnotes summarize "https://youtube.com/watch?v=..."
vidnotes chapters "https://youtube.com/watch?v=..." --json
vidnotes compare "https://youtube.com/watch?v=one" "https://youtube.com/watch?v=two" --json
MCP
{
"mcpServers": {
"vidnotes": {
"command": "npx",
"args": ["-y", "@vidnotes/mcp-server"],
"env": {
"VIDNOTES_API_KEY": "vnp_...",
"VIDNOTES_API_URL": "https://api.vidnotes.app"
}
}
}
}
Tools: vidnotes_summarize_video, vidnotes_get_transcript, vidnotes_get_chapters,
vidnotes_compare_videos, vidnotes_create_note, vidnotes_search_notes,
vidnotes_get_note, vidnotes_get_job, vidnotes_get_usage, vidnotes_doctor,
vidnotes_create_api_key, vidnotes_list_api_keys, vidnotes_revoke_api_key.
Supported sources
Public YouTube URLs, existing VidNotes project ids, raw transcript text, and transcript files through the CLI. Local video upload, rendered clips, and social publishing are not part of this release — the platform is video understanding.
Development
npm install
npm test