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.

Docs: https://vidnotes.app/developers

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

Support

Docs: https://vidnotes.app/developers
Issues: https://github.com/Karniej/vidnotes-platform/issues
Email: contact@silpho.com

vidnotes platform