Skip to main content
Glama
Photo Organizer MCP Server

Photo Organizer MCP Server

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 build

Setup

1. Google Cloud Credentials

You need Google Cloud credentials to access Photos and Drive APIs:

  1. Go to Google Cloud Console

  2. Create a new project

  3. Enable Google Photos Library API and Google Drive API

  4. Create OAuth 2.0 credentials

  5. 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-organizer

3. 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 duplicates

Available Tools

Photo Tools

  1. analyze_photos - Get photo library statistics

    {
      "findDuplicates": true
    }
  2. organize_photos_by_date - Create date-based albums

    {
      "grouping": "year",  // or "month"
      "execute": false     // true to actually create albums
    }

Drive Tools

  1. analyze_drive - Get Drive statistics

  2. organize_drive - Sort files into folders

    {
      "execute": false  // true to actually organize
    }
  3. archive_old_files - Move old files to Archive

    {
      "days": 730,      // Archive files older than this
      "execute": false
    }
  4. 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: true to make changes

  • Detailed 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 tools
analyze_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

    A3.7/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    Six tools is well-scoped for a photo and drive organizer, covering analysis, organization, archiving, and deduplication without being excessive or too thin.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      21
      147 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      29
      40 npm
      1
      MIT