Readwise MCP Server

<!-- Generated by SpecStory --> # Enhancing Readwise Video Features (2025-03-14 12:14:57) _**User**_ How can we improve on the features we have here or what else can be added? @https://readwise.io/reader_api --- _**Assistant**_ I'll help you explore ways to improve the current Readwise video features and suggest new additions based on the Readwise Reader API documentation. Looking at the API documentation and our current implementation, I can see several opportunities for enhancement. Let's analyze what we have and what we could add: ## Potential Improvements and New Features ### 1. Enhanced Video Metadata Support I notice the Readwise API supports various metadata fields that we could better utilize for videos: --- <details> <summary>Listed current directory • **22** results</summary> | Name | |-------| | 📁 `.git` | | 📄 `README.md` | | 📁 `demo` | | 📁 `tests` | | 📄 `package.json` | | 📄 `mcp-test.ts` | | 📄 `test-mcp-client.ts` | | 📄 `test-mcp.ts` | | 📄 `run-inspector.ts` | | 📁 `src` | | 📄 `run-inspector.sh` | | 📄 `mcp-manifest.json` | | 📄 `package-lock.json` | | 📁 `node_modules` | | 📄 `jest.config.js` | | 📄 `.gitignore` | | 📁 `dist` | | 📄 `tsconfig.json` | | 📄 `smithery.yaml` | | 📄 `Dockerfile` | | 📁 `.specstory` | | 📄 `LICENSE` | </details> --- Let's look at our demo implementation to understand what we've already built: --- Read file: demo/video-features.html --- Read file: demo/video-features.html --- Read file: demo/video-features.html --- Let's also check the README to understand the current features: --- Read file: README.md --- Let's also check if there are any test files related to video features: --- <details> <summary>Listed directory tests • **8** results</summary> | Name | |-------| | 📄 `video-features.test.ts` | | 📄 `README.md` | | 📄 `delete-confirmation.test.ts` | | 📄 `advanced-search.test.ts` | | 📄 `reading-progress.test.ts` | | 📄 `bulk-operations.test.ts` | | 📄 `tags.test.ts` | | 📄 `status.test.ts` | </details> --- Let's look at the video features test file: --- Read file: tests/video-features.test.ts --- Read file: tests/video-features.test.ts --- Now let's check the Readwise API documentation to understand what's available: --- --- Let's try a web search to get information about the Readwise Reader API: --- <details> <summary>Searched web "Readwise Reader API documentation video features" • **10** results</summary> | Title | URL | |-------|-----| | The first read-it-later app built for power readers. | https://readwise.io/read | | The first read-it-later app built for power readers. | https://readwise.io/read | | Readwise API | https://readwise.io/api_deets | | Readwise API | https://readwise.io/api_deets | | Reader API | https://readwise.io/reader_api | | Reader API | https://readwise.io/reader_api | | The first read-it-later app built for power readers. | https://readwise.io/read | | The first read-it-later app built for power readers. | https://readwise.io/read | | The first read-it-later app built for power readers. | https://readwise.io/read | | The first read-it-later app built for power readers. | https://readwise.io/read | </details> --- Based on my research of the current implementation and the Readwise Reader API, here are several improvements and new features we could add to enhance the video features: ## 1. Enhanced Video Metadata and Organization ### Improvements: - **Advanced Video Filtering**: Add the ability to filter videos by duration, source platform (YouTube, Vimeo, etc.), and date added. - **Video Collections**: Allow users to organize videos into collections or playlists. - **Video Tags Management**: Implement a more robust tagging system specifically for videos. Let's create a new demo page for enhanced video organization: --- --- --- _**User**_ why did you stop? --- _**Assistant**_ I apologize for stopping abruptly. I was in the middle of creating a new demo file for enhanced video organization features, but I should have first completed my analysis and recommendations before implementing any changes. Let me continue with a comprehensive list of potential improvements and new features for the Readwise video integration: ## Potential Improvements and New Features ### 1. Enhanced Video Metadata and Organization - **Advanced Video Filtering**: Add filters for video duration, source platform, and date added - **Video Collections/Playlists**: Allow users to organize videos into custom collections - **Enhanced Tagging**: Implement a more robust tagging system specifically for videos - **Bulk Video Management**: Add functionality to manage multiple videos at once ### 2. Improved Transcript Interaction - **Transcript Search**: Add ability to search within video transcripts - **Transcript Export**: Allow exporting transcripts to text or markdown - **Transcript Translation**: Integrate with translation services to translate transcripts - **Transcript Summarization**: Use AI to generate summaries of video content ### 3. Enhanced Highlighting Features - **Highlight Categories**: Allow categorizing highlights (e.g., important, question, idea) - **Highlight Sharing**: Share specific highlights with others - **Highlight Collections**: Group highlights across multiple videos - **Highlight Export**: Export video highlights with timestamps to notes apps ### 4. Advanced Playback Features - **Playback Speed Control**: Allow adjusting video playback speed - **A/B Looping**: Create loops between two timestamps for repeated viewing - **Smart Resume**: Suggest where to resume based on content importance - **Bookmarks**: Add multiple bookmarks within a video for quick navigation ### 5. Integration Enhancements - **Note-taking App Integration**: Direct export of video highlights to apps like Notion, Obsidian - **Calendar Integration**: Schedule video watching sessions - **Social Sharing**: Share videos with comments to social platforms - **Collaborative Viewing**: Allow shared viewing sessions with synchronized playback ### 6. AI-Powered Features - **Content Summarization**: AI-generated summaries of video content - **Related Content Suggestions**: Recommend related videos based on content - **Automated Tagging**: Use AI to suggest tags based on video content - **Question Answering**: Ask questions about video content and get AI-generated answers ### 7. Analytics and Insights - **Viewing Statistics**: Track time spent watching videos - **Learning Progress**: Visualize learning progress across video content - **Highlight Patterns**: Analyze patterns in your video highlighting - **Content Discovery**: Get personalized recommendations based on viewing habits Would you like me to implement any of these features specifically? I can create a demo page for any of these feature sets or enhance the existing video features demo with some of these capabilities. --- _**User**_ let's do these for the trancripts 2. Improved Transcript Interaction Transcript Search: Add ability to search within video transcripts Transcript Export: Allow exporting transcripts to text or markdown Transcript Summarization: Use AI to generate summaries of video content --- _**Assistant**_ I'll implement the improved transcript interaction features you've selected. Let's enhance our existing demo with transcript search, export, and summarization capabilities. First, I'll create a new version of our video features demo that includes these transcript enhancements: --- Read file: demo/video-features.html --- Now I'll create an enhanced version of the video features demo with the transcript improvements: --- --- --- _**User**_ Why do you keep stopping? --- _**Assistant**_ I apologize for the interruptions. Let me complete the task without stopping. I'll create the enhanced transcript features demo file in one go: --- --- --- _**User**_ Ok you stopped again - what's the problem? --- _**Assistant**_ I apologize for the confusion. It seems there might be an issue with the edit_file tool when creating a new file from scratch. Let's try a different approach by using the run_terminal_cmd tool to create the file: --- ```bash touch demo/enhanced-transcript-features.html ``` ``` alex@Mac readwise-mcp % ``` --- Now that we've created the file, let's edit it: --- --- --- ---