Eagle MCP Server

Integrations

  • Provides comprehensive integration with the Eagle app, enabling management of folders and items (images, documents, media) in an Eagle library. Supports creating, renaming, and updating folders; adding items from URLs and file paths; retrieving item information, thumbnails, and source files; and managing items through operations like moving to trash and updating metadata.

  • Supports visualization of workflows and architecture diagrams through Mermaid integration, as demonstrated in the use case diagrams showing different deployment scenarios.

Eagle MCP Server (Unofficial)

A Model Context Protocol (MCP) server for Eagle. Wiki

  • JPG / JPEG
  • PNG
  • PDF
  • SVG
  • MP4
  • MP3
  • FBX
  • OBJ
  • EPS
  • TIF / TIFF
  • WebP
  • BMP
  • ICO
  • RAW
  • etc

Requirements

  • Python 3.13
  • uv

Prerequisites

Install the required dependencies:

uv sync

Usage

  1. Launch the Eagle app.
  2. Launch this MCP server by running the following command:
uv run main.py # To use a different endpoint: # EAGLE_API_BASE_URL=http://localhost:12345 uv run main.py

Connecting to the MCP Server using SSE

All the most popular MCP clients (Claude Desktop, Cursor & Windsurf) use the following config format:

{ "mcpServers": { "eagle-mcp-server": { "url": "http://localhost:8000/mcp" } } }

VS Code

"mcp": { "servers": { "eagle-mcp-server": { "type": "sse", "url": "http://localhost:8000/mcp" } } }

Tools

SupportedOperation IDAPI endpointEnabled (default)Category
connect/api/connectMCP
get_application_info/api/application/info⚫︎Application
create_folder/api/folder/create⚫︎Folder
rename_folder/api/folder/renameFolder
update_folder/api/folder/update⚫︎Folder
get_folder_list/api/folder/list⚫︎Folder
get_folder_list_recent/api/folder/listRecentFolder
add_item_from_url/api/item/addFromURLItem
add_items_from_urls/api/item/addFromURLsItem
add_item_from_path/api/item/addFromPath⚫︎Item
add_items_from_paths/api/item/addFromPathsItem
[ ]add_bookmark/api/item/addBookmark⚫︎Item
get_item_info/api/item/info⚫︎Item
get_item_source/api/item/source⚫︎Item
get_item_thumbnail/api/item/thumbnailItem
get_item_list/api/item/list⚫︎Item
move_item_to_trash/api/item/moveToTrash⚫︎Item
refresh_item_palette/api/item/refreshPaletteItem
refresh_item_thumbnail/api/item/refreshThumbnailItem
update_item/api/item/update⚫︎Item
get_library_info/api/library/info⚫︎Library
get_library_history/api/library/historyLibrary
switch_library/api/library/switchLibrary
get_library_icon/api/library/iconLibrary
[ ].........

MCP Server API docs:

Use Cases

Tip

You have direct access to the filesystem.

2) Same Host (Eagle App, MCP Server) + Other Host (MCP Client)

Warning

You don't have access to the filesystem.

3) Other Host

Warning

You don't have access to the filesystem.

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Eagle MCP Server

  1. Requirements
    1. Prerequisites
      1. Usage
        1. Connecting to the MCP Server using SSE
          1. Tools
            1. Use Cases
              1. 1) Same Host (Recommended)
              2. 2) Same Host (Eagle App, MCP Server) + Other Host (MCP Client)
              3. 3) Other Host

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              An MCP server to interact with a Tinybird Workspace from any MCP client.
              Last updated -
              51
              Python
              Apache 2.0
              • Apple
            • -
              security
              A
              license
              -
              quality
              MCP Server for Netbird
              Last updated -
              28
              Go
              Apache 2.0
            • -
              security
              F
              license
              -
              quality
              This MCP server allows users to create, manage, and serve web applications through Goose, storing apps in configurable directories and providing web app serving capabilities.
              Last updated -
              JavaScript
              • Linux
              • Apple

            View all related MCP servers

            ID: 4nh0x7rti7