{
  "markdown": "# Photo Organizer MCP Server\n\n**AI-powered organization for Google Photos and Google Drive.**\n\nThis MCP server enables AI agents like Claude to automatically organize your Google Photos and Drive files. Perfect for decluttering cloud storage, finding duplicates, and maintaining organized photo albums.\n\n## Features\n\n### Google Photos\n- 📊 **Analyze Library**: Get statistics and insights about your photo collection\n- 🔍 **Find Duplicates**: Identify potential duplicate photos\n- 📅 **Auto-Organize**: Create albums by year or month\n- 📈 **Reports**: Generate detailed organization reports\n\n### Google Drive\n- 📂 **Auto-Organize**: Sort files into folders by type (Documents, Images, Videos, etc.)\n- 🗄️ **Archive Old Files**: Move old files to Archive folder\n- 🔄 **Deduplicate**: Find and remove exact duplicate files\n- 📊 **Analytics**: Get file statistics and storage insights\n\n## Installation\n\n```bash\n# Install from NPM\nnpm install -g photo-organizer-mcp\n\n# Or clone and build\ngit clone https://github.com/ExpertVagabond/photo-organizer-mcp\ncd photo-organizer-mcp\nnpm install\nnpm run build\n```\n\n## Setup\n\n### 1. Google Cloud Credentials\n\nYou need Google Cloud credentials to access Photos and Drive APIs:\n\n1. Go to [Google Cloud Console](https://console.cloud.google.com/)\n2. Create a new project\n3. Enable **Google Photos Library API** and **Google Drive API**\n4. Create OAuth 2.0 credentials\n5. Download `credentials.json`\n\n### 2. Python Scripts\n\nThis MCP server wraps existing Python organizer scripts. Set the path:\n\n```bash\nexport PHOTO_SCRIPTS_PATH=\"/path/to/drive-photos-organizer\"\n```\n\nOr add to `.env`:\n```\nPHOTO_SCRIPTS_PATH=/Users/yourname/drive-photos-organizer\n```\n\n### 3. Configure Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"photo-organizer\": {\n      \"command\": \"photo-organizer-mcp\",\n      \"env\": {\n        \"PHOTO_SCRIPTS_PATH\": \"/path/to/drive-photos-organizer\"\n      }\n    }\n  }\n}\n```\n\n## Usage Examples\n\n### With Claude\n\n**\"Analyze my Google Photos and find duplicates\"**\n```\nClaude will use the analyze_photos tool to scan your library\n```\n\n**\"Organize my photos into albums by year\"**\n```\nClaude will create year-based albums (dry run first, then execute)\n```\n\n**\"Clean up my Google Drive by organizing files into folders\"**\n```\nClaude will sort files by type into organized folders\n```\n\n**\"Archive all Drive files older than 2 years\"**\n```\nClaude will move old files to an Archive folder\n```\n\n**\"Find and remove duplicate files from my Drive\"**\n```\nClaude will identify and remove exact duplicates\n```\n\n## Available Tools\n\n### Photo Tools\n\n1. **analyze_photos** - Get photo library statistics\n   ```json\n   {\n     \"findDuplicates\": true\n   }\n   ```\n\n2. **organize_photos_by_date** - Create date-based albums\n   ```json\n   {\n     \"grouping\": \"year\",  // or \"month\"\n     \"execute\": false     // true to actually create albums\n   }\n   ```\n\n### Drive Tools\n\n3. **analyze_drive** - Get Drive statistics\n\n4. **organize_drive** - Sort files into folders\n   ```json\n   {\n     \"execute\": false  // true to actually organize\n   }\n   ```\n\n5. **archive_old_files** - Move old files to Archive\n   ```json\n   {\n     \"days\": 730,      // Archive files older than this\n     \"execute\": false\n   }\n   ```\n\n6. **deduplicate_drive** - Remove duplicate files\n   ```json\n   {\n     \"execute\": false  // true to actually delete\n   }\n   ```\n\n## Safety Features\n\n- **Dry Run by Default**: All operations default to dry run mode\n- **Explicit Execution**: Must set `execute: true` to make changes\n- **Detailed Reports**: See exactly what will happen before executing\n- **Non-Destructive**: Organizes and archives, doesn't delete (except deduplication)\n\n## Monetization (Pro Version)\n\nUpgrade for advanced features:\n\n### Free Tier\n- 50 operations per month\n- Basic organization\n- Manual execution required\n\n### Pro ($10/month)\n- Unlimited operations\n- Scheduled auto-organization\n- Advanced duplicate detection\n- Priority support\n\n### Enterprise ($50/month)\n- White-label branding\n- Team management\n- Custom rules engine\n- API access\n\n## Technical Details\n\n- Built with TypeScript and Model Context Protocol SDK\n- Wraps Python scripts for Google API integration\n- Async operation with progress reporting\n- Handles large libraries (10,000+ photos)\n\n## Contributing\n\nContributions welcome! Please open issues or PRs on GitHub.\n\n## License\n\nMIT License - see LICENSE file\n\n## Author\n\nExpertVagabond - https://github.com/ExpertVagabond\n\n---\n\n**Need help?** Contact: hello@expertvagabond.com\n",
  "bytes": 4535,
  "sha": "e37c1e7782e448569b9229507aeaf909f34e0d6b1d2b84ba1ffda1ebff853ce0",
  "repo_slug": "expertvagabond/photo-organizer-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_expertvagabond_photo_organizer_e5005c19/readme"
}