immich_albums_delete

Delete an album. This does not delete the assets inside it.

Server Immich whitehara/immich-mcp
Category Destructive
Risk class Critical
Parameters 00 required

What immich_albums_delete does on Immich

AI agents call immich_albums_delete to permanently remove resources in Immich — typically in cleanup and lifecycle workflows. It does its job in a single call, and there is no undo.

Why immich_albums_delete needs a policy

This tool permanently removes an album record from the Immich system. Although the underlying photo assets are preserved (as noted in the description), the album itself—including its metadata, organization, and any associated metadata like album name, description, cover photo, and sharing settings—is irreversibly deleted.

From the tool's definition Tool name is 'immich_albums_delete' and description states 'Delete an album.' The verb 'delete' combined with the irreversible nature of removing an album metadata structure constitutes a destructive action that cannot be easily undone.

Questions about immich_albums_delete

What does the immich_albums_delete tool do? +

Delete an album. This does not delete the assets inside it. It is categorised as a Destructive tool in the Immich MCP Server, which means it can permanently delete or destroy data. Block by default and require explicit approval.

How do I enforce a policy on immich_albums_delete? +

Register the Immich MCP server in PolicyLayer and add a rule for immich_albums_delete: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Immich. Nothing to install.

What risk level is immich_albums_delete? +

immich_albums_delete is a Destructive tool with critical risk. Critical-risk tools should be blocked by default and only enabled with explicit human approval.

Can I rate-limit immich_albums_delete? +

Yes. Add a rate_limit block to the immich_albums_delete rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block immich_albums_delete completely? +

Set action: deny in the PolicyLayer policy for immich_albums_delete. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides immich_albums_delete? +

immich_albums_delete is provided by the Immich MCP server (whitehara/immich-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// LOOK UP ANOTHER SERVER

Every MCP server has a record like this.

Type a name, get the same breakdown: verified identity, auth posture, risk grade, capabilities, recommended policy.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.