YouTube MCP Server

Instructions

Implementation Reference

• src/services/playlist.ts:37-52 (handler)

  Core implementation of the playlists_getPlaylist tool logic, calling YouTube Data API v3 playlists.list to retrieve playlist details.
  async getPlaylist({ playlistId }: PlaylistParams): Promise<unknown> { try { this.initialize(); const response = await this.youtube.playlists.list({ part: ['snippet', 'contentDetails'], id: [playlistId] }); return response.data.items?.[0] || null; } catch (error) { throw new Error(`Failed to get playlist: ${error instanceof Error ? error.message : String(error)}`); } }
• src/server-utils.ts:244-263 (registration)

  Registers the 'playlists_getPlaylist' tool with the MCP server, including input schema, description, and a thin handler that delegates to PlaylistService.getPlaylist.
  server.registerTool( 'playlists_getPlaylist', { title: 'Get Playlist Information', description: 'Get information about a YouTube playlist', annotations: { readOnlyHint: true, idempotentHint: true }, inputSchema: { playlistId: z.string().describe('The YouTube playlist ID'), }, }, async ({ playlistId }) => { const result = await playlistService.getPlaylist({ playlistId }); return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] }; } );
• src/server-utils.ts:250-252 (schema)

  Zod-based input schema for the tool, defining the required 'playlistId' parameter.
  inputSchema: { playlistId: z.string().describe('The YouTube playlist ID'), },
• src/types.ts:66-71 (schema)

  TypeScript interface defining the parameters for the playlist service method.
  /** * Playlist parameters */ export interface PlaylistParams { playlistId: string; }
• src/services/playlist.ts:18-32 (helper)

  Helper method to lazily initialize the YouTube API client using the API key from environment variables.
  private initialize() { if (this.initialized) return; const apiKey = process.env.YOUTUBE_API_KEY; if (!apiKey) { throw new Error('YOUTUBE_API_KEY environment variable is not set.'); } this.youtube = google.youtube({ version: "v3", auth: apiKey }); this.initialized = true; }