Eagle MCP Server (Unofficial)

Name: Eagle MCP Server (Unofficial)
Author: tuki0918

@tuki0918

Repository

About Eagle MCP Server (Unofficial)

[MCP] A Model Context Protocol (MCP) server for Eagle. Manages local media files (e.g., images, mp3, mp4)

#filesystem #eagle #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "eagle-mcp-server": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Tools

http://localhost:8000/redoc

Overview

What is Eagle MCP Server (Unofficial)?

An unofficial Model Context Protocol (MCP) server for the Eagle digital asset management app. It exposes Eagle’s local API through MCP tools, enabling AI assistants to interact with folders, items, libraries, and application settings. Designed for users who want to automate or extend Eagle workflows via MCP-compatible clients.

How to use Eagle MCP Server (Unofficial)?

Install dependencies with uv sync (Python 3.13 and uv required).
Launch the Eagle app.
Run the server: uv run main.py.
In your MCP client, configure a server with URL http://localhost:8000/mcp (Streamable HTTP). For stdio transport, use the alternative configuration with uvx and the fastmcp-stdio branch.

Key features of Eagle MCP Server (Unofficial)

20+ tools covering folders, items, libraries, and application info.
Add items from URL, file path, or create bookmarks.
Create, rename, update, and list folders.
Retrieve item details, thumbnails, and color palettes.
Move items to trash, update metadata, and refresh thumbnails.
Some tools are disabled by default (can be enabled by editing source).

Use cases of Eagle MCP Server (Unofficial)

Automate asset ingestion by adding items from URLs or local paths via AI agents.
Organize libraries programmatically: create folders, rename, or update folder properties.
Query Eagle metadata (application info, library history) without leaving your MCP client.
Build AI‑powered workflows that search, tag, or move assets inside Eagle.
Run the server on the same host as Eagle for full filesystem access, or on a separate host for remote control.