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

| 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: [email protected]