Eagle MCP Server

Eagle MCP Server (Unofficial)

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

Install the required dependencies:

uv sync

uv run main.py
# To use a different endpoint:
# EAGLE_API_BASE_URL=http://localhost:12345 uv run main.py

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"
        }
    }
}

Supported	Operation ID	API endpoint	Enabled (default)	Category
✅	`connect`	/api/connect		MCP
✅	`get_application_info`	/api/application/info	⚫︎	Application
✅	`create_folder`	/api/folder/create	⚫︎	Folder
✅	`rename_folder`	/api/folder/rename		Folder
✅	`update_folder`	/api/folder/update	⚫︎	Folder
✅	`get_folder_list`	/api/folder/list	⚫︎	Folder
✅	`get_folder_list_recent`	/api/folder/listRecent		Folder
✅	`add_item_from_url`	/api/item/addFromURL		Item
✅	`add_items_from_urls`	/api/item/addFromURLs		Item
✅	`add_item_from_path`	/api/item/addFromPath	⚫︎	Item
✅	`add_items_from_paths`	/api/item/addFromPaths		Item
✅	`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/thumbnail		Item
✅	`get_item_list`	/api/item/list	⚫︎	Item
✅	`move_item_to_trash`	/api/item/moveToTrash	⚫︎	Item
✅	`refresh_item_palette`	/api/item/refreshPalette		Item
✅	`refresh_item_thumbnail`	/api/item/refreshThumbnail		Item
✅	`update_item`	/api/item/update	⚫︎	Item
✅	`get_library_info`	/api/library/info	⚫︎	Library
✅	`get_library_history`	/api/library/history		Library
✅	`switch_library`	/api/library/switch		Library
✅	`get_library_icon`	/api/library/icon		Library
[ ]	...	...		...

MCP Server API docs:

Tip

You have direct access to the filesystem.

Warning

You don't have access to the filesystem.

Warning

You don't have access to the filesystem.