Photo Organizer MCP Server
Provides tools for organizing files into folders by type, archiving old files, finding and removing duplicate files, and getting file storage analytics.
Provides tools for analyzing photo library, finding duplicates, organizing photos into albums by year or month, and generating reports.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Photo Organizer MCP Server Find duplicate photos in my Google Photos library."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Photo Organizer MCP Server
AI-powered organization for Google Photos and Google Drive.
This 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.
Features
Google Photos
π Analyze Library: Get statistics and insights about your photo collection
π Find Duplicates: Identify potential duplicate photos
π Auto-Organize: Create albums by year or month
π Reports: Generate detailed organization reports
Google Drive
π Auto-Organize: Sort files into folders by type (Documents, Images, Videos, etc.)
ποΈ Archive Old Files: Move old files to Archive folder
π Deduplicate: Find and remove exact duplicate files
π Analytics: Get file statistics and storage insights
Related MCP server: Krakenfy Drive MCP
Installation
# Install from NPM
npm install -g photo-organizer-mcp
# Or clone and build
git clone https://github.com/ExpertVagabond/photo-organizer-mcp
cd photo-organizer-mcp
npm install
npm run buildSetup
1. Google Cloud Credentials
You need Google Cloud credentials to access Photos and Drive APIs:
Go to Google Cloud Console
Create a new project
Enable Google Photos Library API and Google Drive API
Create OAuth 2.0 credentials
Download
credentials.json
2. Python Scripts
This MCP server wraps existing Python organizer scripts. Set the path:
export PHOTO_SCRIPTS_PATH="/path/to/drive-photos-organizer"Or add to .env:
PHOTO_SCRIPTS_PATH=/Users/yourname/drive-photos-organizer3. Configure Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"photo-organizer": {
"command": "photo-organizer-mcp",
"env": {
"PHOTO_SCRIPTS_PATH": "/path/to/drive-photos-organizer"
}
}
}
}Usage Examples
With Claude
"Analyze my Google Photos and find duplicates"
Claude will use the analyze_photos tool to scan your library"Organize my photos into albums by year"
Claude will create year-based albums (dry run first, then execute)"Clean up my Google Drive by organizing files into folders"
Claude will sort files by type into organized folders"Archive all Drive files older than 2 years"
Claude will move old files to an Archive folder"Find and remove duplicate files from my Drive"
Claude will identify and remove exact duplicatesAvailable Tools
Photo Tools
analyze_photos - Get photo library statistics
{ "findDuplicates": true }organize_photos_by_date - Create date-based albums
{ "grouping": "year", // or "month" "execute": false // true to actually create albums }
Drive Tools
analyze_drive - Get Drive statistics
organize_drive - Sort files into folders
{ "execute": false // true to actually organize }archive_old_files - Move old files to Archive
{ "days": 730, // Archive files older than this "execute": false }deduplicate_drive - Remove duplicate files
{ "execute": false // true to actually delete }
Safety Features
Dry Run by Default: All operations default to dry run mode
Explicit Execution: Must set
execute: trueto make changesDetailed Reports: See exactly what will happen before executing
Non-Destructive: Organizes and archives, doesn't delete (except deduplication)
Monetization (Pro Version)
Upgrade for advanced features:
Free Tier
50 operations per month
Basic organization
Manual execution required
Pro ($10/month)
Unlimited operations
Scheduled auto-organization
Advanced duplicate detection
Priority support
Enterprise ($50/month)
White-label branding
Team management
Custom rules engine
API access
Technical Details
Built with TypeScript and Model Context Protocol SDK
Wraps Python scripts for Google API integration
Async operation with progress reporting
Handles large libraries (10,000+ photos)
Contributing
Contributions welcome! Please open issues or PRs on GitHub.
License
MIT License - see LICENSE file
Author
ExpertVagabond - https://github.com/ExpertVagabond
Need help? Contact: hello@expertvagabond.com
Available Tools
6 toolsanalyze_driveA
Analyze Google Drive - get file statistics, find duplicates, and generate a report
Inputs: findDuplicates.
analyze_photosA
Analyze Google Photos library - get statistics, find duplicates, and generate a report
Inputs: findDuplicates.
archive_old_filesB
Move old Drive files (older than specified days) to an Archive folder
Inputs: days, execute.
deduplicate_driveB
Remove exact duplicate files from Google Drive
Inputs: execute.
organize_driveA
Organize Google Drive files into folders by type (Documents, Images, Videos, etc.)
Inputs: execute.
organize_photos_by_dateB
Organize Google Photos into albums by date (year or month)
Inputs: grouping (required), execute.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 6 tools
Each tool targets a distinct resource and action: analyze vs organize, photos vs drive, and specific operations like archiving and deduplication. No two tools have overlapping purposes, so an agent can easily select the right one.
Tool names mostly follow a verb_noun pattern (analyze_photos, organize_drive), but there is variation such as organize_photos_by_date including a modifier and archive_old_files/deduplicate_drive using different verb forms. The style is readable and consistent enough, though not perfectly uniform.
Six tools is well-scoped for a photo and drive organizer, covering analysis, organization, archiving, and deduplication without being excessive or too thin.
The server covers core workflows for analyzing and organizing both Photos and Drive, plus archiving and deduplicating Drive files. A notable gap is the lack of a deduplicate_photos toolβanalyze_photos finds duplicates but does not offer removal, so photo deduplication is incomplete.
Maintenance
Related MCP Connectors
Search photos and video moments by visual meaning, people, dates, and folders across local libraries, Apple Photos, and OneDrive. Manage collections, groups, favorites, people, and duplicate review. Synced metadata remains searchable while the desktop is offline; local and Apple Photos media access needs the owning device online with remote access enabled. OneDrive media can be accessed directly from the cloud. OAuth or Bearer API keys. Paid Cloud Access required; hosted visual search uses prepaid credits. Text-in-image search is semantic matching, not guaranteed exact OCR. Setup: https://organizewith.ai/en/guides/connect-ai-assistants
One personal memory for all your AI agents: partitioned, token-budgeted, kept in your Drive.
Connect an AI assistant to your Google Sheets, Drive, Docs, PDFs, BigQuery and Gmail.
Gmail, Outlook, Drive, OneDrive and calendars for AI agents. Many accounts, one endpoint, audit log.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Google Drive, supporting file operations like list, search, read, create, update, delete, share, and manage permissions.74MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to automate Google Drive tasks such as provisioning workspaces, reusing templates, inspecting folder structures, updating reports, and sharing files through user-controlled OAuth.MIT
- AlicenseAqualityBmaintenanceEnables AI apps to work with Google Drive in plain language, including searching, organizing, uploading, downloading, exporting, sharing, and commenting on files, with reversible trash and configurable access scopes.21147 npmMIT
- AlicenseAqualityBmaintenanceEnables AI agents to work with a user's Google Photos through Google's picker, letting users choose exactly what the agent sees while providing tools for uploading media, creating and sharing albums, writing captions and enrichments, searching app-created media, and managing multiple Google accounts.2940 npm1MIT