Immich (Google Photos Alternative) MCP Server for Mastra AIGive Mastra AI instant access to 26 tools to Create Album, Create Person, Create Tag, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Immich (Google Photos Alternative) through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Immich (Google Photos Alternative) MCP Server for Mastra AI is a standout in the Image Video category — giving your AI agent 26 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"immich-google-photos-alternative": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Immich (Google Photos Alternative) Agent",
instructions:
"You help users interact with Immich (Google Photos Alternative) " +
"using 26 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Immich (Google Photos Alternative)?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Immich (Google Photos Alternative) MCP Server
Connect your self-hosted Immich instance to any AI agent and take full control of your digital media library through natural conversation. Immich is the leading open-source alternative to Google Photos, and this MCP server allows you to interact with your assets, albums, and server settings seamlessly.
Mastra's agent abstraction provides a clean separation between LLM logic and Immich (Google Photos Alternative) tool infrastructure. Connect 26 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Asset Management — List, fetch, update, and delete photos or videos. You can even upload new media directly from your local environment.
- Album Organization — Create and manage albums to keep your memories organized without manual clicking.
- User & Person Administration — List and manage users, persons (faces), and tags to maintain a clean and searchable library.
- Server Monitoring — Instantly check your Immich server version and status to ensure everything is running smoothly.
The Immich (Google Photos Alternative) MCP Server exposes 26 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 26 Immich (Google Photos Alternative) tools available for Mastra AI
When Mastra AI connects to Immich (Google Photos Alternative) through Vinkius, your AI agent gets direct access to every tool listed below — spanning self-hosted, photo-management, media-library, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Create album on Immich (Google Photos Alternative)
Create a new album
Create person on Immich (Google Photos Alternative)
Create a new person record
Create tag on Immich (Google Photos Alternative)
Create a new tag
Create user on Immich (Google Photos Alternative)
Create a new user
Delete album on Immich (Google Photos Alternative)
Delete an album
Delete asset on Immich (Google Photos Alternative)
Delete an Immich asset
Delete person on Immich (Google Photos Alternative)
Delete a person record
Delete tag on Immich (Google Photos Alternative)
Delete a tag
Delete user on Immich (Google Photos Alternative)
Delete a user
Get album on Immich (Google Photos Alternative)
Get details for a specific album
Get asset on Immich (Google Photos Alternative)
Get details for a specific Immich asset
Get person on Immich (Google Photos Alternative)
Get details for a specific person
Get server info on Immich (Google Photos Alternative)
Get Immich server version and status information
Get tag on Immich (Google Photos Alternative)
Get details for a specific tag
Get user on Immich (Google Photos Alternative)
Get details for a specific user
List albums on Immich (Google Photos Alternative)
List all albums in Immich
List assets on Immich (Google Photos Alternative)
List all assets (photos/videos) in Immich
List persons on Immich (Google Photos Alternative)
List all recognized persons in Immich
List tags on Immich (Google Photos Alternative)
List all tags in Immich
List users on Immich (Google Photos Alternative)
List all users in Immich
Update album on Immich (Google Photos Alternative)
Update an existing album
Update asset on Immich (Google Photos Alternative)
g., isFavorite). Update an existing Immich asset
Update person on Immich (Google Photos Alternative)
Update an existing person (e.g., change name)
Update tag on Immich (Google Photos Alternative)
Update an existing tag
Update user on Immich (Google Photos Alternative)
Update an existing user
Upload asset on Immich (Google Photos Alternative)
Upload a new photo or video to Immich
Connect Immich (Google Photos Alternative) to Mastra AI via MCP
Follow these steps to wire Immich (Google Photos Alternative) into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Immich (Google Photos Alternative) MCP Server
Mastra AI provides unique advantages when paired with Immich (Google Photos Alternative) through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Immich (Google Photos Alternative) without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Immich (Google Photos Alternative) tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Immich (Google Photos Alternative) + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Immich (Google Photos Alternative) MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Immich (Google Photos Alternative), process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Immich (Google Photos Alternative) as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Immich (Google Photos Alternative) on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Immich (Google Photos Alternative) tools alongside other MCP servers
Example Prompts for Immich (Google Photos Alternative) in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Immich (Google Photos Alternative) immediately.
"List all my photos in Immich."
"Create a new album called 'Summer Vacation 2024'."
"Get the details for asset 550e8400-e29b-41d4-a716-446655440000."
Troubleshooting Immich (Google Photos Alternative) MCP Server with Mastra AI
Common issues when connecting Immich (Google Photos Alternative) to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpImmich (Google Photos Alternative) + Mastra AI FAQ
Common questions about integrating Immich (Google Photos Alternative) MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Basecamp
7 toolsManage your Basecamp projects via AI — list tasks, read message boards, track campfire logs, and orchestrate to-dos seamlessly.
FRED Series — U.S. Economic Time Series
5 toolsSearch and retrieve data from 816,000+ official U.S. economic time series: GDP, inflation, unemployment, interest rates, money supply — with built-in transformations, frequency aggregation, and vintage analysis.
Tatango
12 toolsRun high-volume SMS and MMS campaigns for enterprise marketing with compliance tools that keep you TCPA-safe at scale.
Coda
11 toolsCombine docs, spreadsheets, and apps into powerful all-in-one documents that grow with your team and automate routine work.