# Photo Organizer Mcp

> AI-powered organization for Google Photos and Drive - auto-organize, find duplicates, create albums

- **Type:** MCP server
- **Install:** `agentstack add mcp-expertvagabond-photo-organizer-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ExpertVagabond](https://agentstack.voostack.com/s/expertvagabond)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 1.0.0
- **License:** MIT
- **Upstream author:** [ExpertVagabond](https://github.com/ExpertVagabond)
- **Source:** https://github.com/ExpertVagabond/photo-organizer-mcp
- **Website:** - Creating gist photo-organizer-mcp-quickstart.md
✓ Created public gist photo-organizer-mcp-quickstart.md
https://gist.github.com/ExpertVagabond/609dc960b822fe78237e49bcc3a6774b

## Install

```sh
agentstack add mcp-expertvagabond-photo-organizer-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

## Installation

```bash
# 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](https://console.cloud.google.com/)
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:

```bash
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`:

```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
   ```json
   {
     "findDuplicates": true
   }
   ```

2. **organize_photos_by_date** - Create date-based albums
   ```json
   {
     "grouping": "year",  // or "month"
     "execute": false     // true to actually create albums
   }
   ```

### Drive Tools

3. **analyze_drive** - Get Drive statistics

4. **organize_drive** - Sort files into folders
   ```json
   {
     "execute": false  // true to actually organize
   }
   ```

5. **archive_old_files** - Move old files to Archive
   ```json
   {
     "days": 730,      // Archive files older than this
     "execute": false
   }
   ```

6. **deduplicate_drive** - Remove duplicate files
   ```json
   {
     "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

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ExpertVagabond](https://github.com/ExpertVagabond)
- **Source:** [ExpertVagabond/photo-organizer-mcp](https://github.com/ExpertVagabond/photo-organizer-mcp)
- **License:** MIT
- **Homepage:** - Creating gist photo-organizer-mcp-quickstart.md
✓ Created public gist photo-organizer-mcp-quickstart.md
https://gist.github.com/ExpertVagabond/609dc960b822fe78237e49bcc3a6774b

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v1.0.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **1.0.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-expertvagabond-photo-organizer-mcp
- Seller: https://agentstack.voostack.com/s/expertvagabond
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.