Vidnotes

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.

Docs: https://vidnotes.app/developers

Packages

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

Support

• Docs: https://vidnotes.app/developers
• Issues: https://github.com/Karniej/vidnotes-platform/issues
• Email: [email protected]