Photo Organizer

You can use this MCP server to automatically organize your Google Photos and Google Drive with AI-powered agents. It helps declutter cloud storage, detect duplicates, and maintain organized photo albums by leveraging built-in Python scripts through a lightweight MCP interface.

How to use

You interact with the server through an MCP client. This server exposes tools to analyze your Google Photos library, find duplicates, and auto-organize photos into year or month-based albums, as well as organize Google Drive files by type, archive old items, deduplicate, and provide analytics. Use natural language prompts to trigger specific workflows, review the prepared dry-run reports, and then choose to execute the changes.

How to install

Prerequisites you need before running the server:

• Install Node.js from the official source and ensure npm is available by running npm -v

• Verify by running git --version

• Ensure Python is installed and accessible in your PATH

Step-by-step commands to set up and run the MCP server locally:

# 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 build

Additional setup and configuration

Configure credentials and script paths to connect with Google Photos and Drive and to point to your Python-based organizer scripts.

Usage notes

The server expects you to provide Google Cloud credentials and path to the Python scripts that perform the actual organization tasks. You will set environment variables and configure your MCP client to reference the server and its tools.

Security and safety considerations

All operations can be performed in a dry-run mode by default. You must explicitly request execution to apply changes. Review the generated reports to understand what will happen before any action is taken.

Available tools

analyze_photos

Get photo library statistics and insights about your Google Photos collection.

find_duplicates_photos

Identify potential duplicate photos in your Google Photos library.

organize_photos_by_date

Create albums organized by year or month based on photo dates.

analyze_drive

Get statistics and insights for your Google Drive files.

organize_drive

Sort Drive files into folders by type and category.

archive_old_files

Move files older than a specified number of days to an Archive folder.

deduplicate_drive

Find and remove exact duplicate files from Google Drive.