Eagle MCP Server (Unofficial)

@tuki0918

Repository

Basic information

About Eagle MCP Server

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

#filesystem#eagle#mcp-server

Eagle MCP Server config

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

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

Eagle MCP Server 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.

Frequently asked questions

Is this the official Eagle MCP support?

No – this is an unofficial server. Official MCP support is planned for Eagle v5 (public beta in Q1 2026).

What are the runtime requirements?

Python 3.13 and the `uv` package manager. The server also requires the Eagle desktop app to be running locally.

Which file formats does Eagle MCP Server support?

It supports JPG/JPEG, PNG, PDF, SVG, MP4, MP3, FBX, OBJ, EPS, TIF/TIFF, WebP, BMP, ICO, RAW, and others.

How do I enable disabled tools?

Some tools are disabled by default. Locate the tool definition in the source code, remove the `tags=["Disabled"]` line, and restart the server.

What transport protocols are available?

Streamable HTTP (default, URL `http://localhost:8000/mcp`) and stdio (alternative config using `uvx` and a `fastmcp-stdio` branch).

Comments

More Other MCP servers

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3