How to Use the Immich (Google Photos Alternative) MCP in CrewAI

Q: How do I expose Immich (Google Photos Alternative) tools to a CrewAI agent?

You can pass your Vinkius server URL directly into the mcps array of your Agent configuration. CrewAI automatically fetches the MCP tool definitions like listassets and makes them available to the agent.

Q: How does CrewAI prevent agents from messing up my Immich (Google Photos Alternative) albums?

You can restrict tool access by using MCPServerHTTP with a toolfilter to only expose safe tools like listalbums and getasset, completely hiding destructive tools like deleteasset.

Deploy specialized agent crews to organize and audit your self-hosted media library with CrewAI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Immich (Google Photos Alternative) MCP to CrewAI

Create your Vinkius account to connect Immich (Google Photos Alternative) to CrewAI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Immich (Google Photos Alternative) with CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Coordinate multi-agent photo curation in CrewAI

This MCP Server allows multiple specialized agents to work together to tidy up your library. One agent can act as the Curator, scanning your library with `list_assets` and `list_albums`, while a second agent acts as the Organizer to group them. The Organizer agent uses `create_album` and `update_asset` to place photos into logical folders based on dates or themes. Because CrewAI agents share memory, they coordinate their actions to prevent editing the same asset simultaneously.

Run autonomous tagging crews on your server

Cleaning up messy facial recognition tags using `list_persons` is the perfect job for an autonomous crew. Your Tagging Agent can query recognized faces using `list_persons` and `list_tags` to identify duplicates or unnamed profiles. Once identified, a separate Moderator Agent can invoke `update_person` or `create_tag` to clean up the records. This two-step process ensures that automated metadata changes are cross-checked before being written to your database.

Deploy an autonomous MCP Server administrator

Monitoring your self-hosted hardware is simple when an agent team has access to administrative tools like `get_server_info`. A Monitor Agent can periodically call the server to check version status and verify that the system is online. If anomalies are found, an Escalation Agent can fetch active accounts using `list_users` and flag inactive profiles using `get_user`. This keeps your user roster clean without requiring you to log into the admin dashboard manually.

Setup guide

Set up Immich (Google Photos Alternative) MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke Immich (Google Photos Alternative) tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="Immich (Google Photos Alternative) Analyst",
    goal="Access and analyze Immich (Google Photos Alternative) data via MCP.",
    backstory="Expert analyst with direct Immich (Google Photos Alternative) access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent Immich (Google Photos Alternative) transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="Immich (Google Photos Alternative) Analyst",
        goal="Access and analyze Immich (Google Photos Alternative) data via MCP.",
        backstory="Expert analyst with direct Immich (Google Photos Alternative) access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent Immich (Google Photos Alternative) transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Immich. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Immich (Google Photos Alternative) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Immich (Google Photos Alternative) MCP in CrewAI

You can pass your Vinkius server URL directly into the `mcps` array of your Agent configuration. CrewAI automatically fetches the MCP tool definitions like `list_assets` and makes them available to the agent.

Yes, you can set up a sequential crew where a File Watcher agent detects new media and passes the path to an Ingestion Agent, which runs `upload_asset` to save the file.

You can restrict tool access by using `MCPServerHTTP` with a `tool_filter` to only expose safe tools like `list_albums` and `get_asset`, completely hiding destructive tools like `delete_asset`.

CrewAI supports standard MCP transports, including stdio, SSE, and Streamable HTTP, allowing you to connect to your managed Vinkius endpoint directly.

Your actual photo files, video files, and user credentials stay on your self-hosted hardware. The CrewAI agents only process the JSON metadata returned by tools like `get_asset` inside an ephemeral, zero-trust sandbox environment.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript