ImageKit MCP Server

A Model Context Protocol (MCP) server for ImageKit.io that lets AI assistants upload, search, transform, and manage media assets in your ImageKit media library.

Quick Start

npx imagekit-mcp-server

Requires three environment variables:

IMAGEKIT_PUBLIC_KEY=public_xxx
IMAGEKIT_PRIVATE_KEY=private_xxx
IMAGEKIT_URL_ENDPOINT=https://ik.imagekit.io/your_id

Get your credentials from the ImageKit Dashboard.

MCP Client Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "imagekit": {
      "command": "npx",
      "args": ["-y", "imagekit-mcp-server"],
      "env": {
        "IMAGEKIT_PUBLIC_KEY": "public_xxx",
        "IMAGEKIT_PRIVATE_KEY": "private_xxx",
        "IMAGEKIT_URL_ENDPOINT": "https://ik.imagekit.io/your_id"
      }
    }
  }
}

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "imagekit": {
      "command": "npx",
      "args": ["-y", "imagekit-mcp-server"],
      "env": {
        "IMAGEKIT_PUBLIC_KEY": "public_xxx",
        "IMAGEKIT_PRIVATE_KEY": "private_xxx",
        "IMAGEKIT_URL_ENDPOINT": "https://ik.imagekit.io/your_id"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "imagekit": {
      "command": "npx",
      "args": ["-y", "imagekit-mcp-server"],
      "env": {
        "IMAGEKIT_PUBLIC_KEY": "public_xxx",
        "IMAGEKIT_PRIVATE_KEY": "private_xxx",
        "IMAGEKIT_URL_ENDPOINT": "https://ik.imagekit.io/your_id"
      }
    }
  }
}

Tools

| Tool | Description | |------|-------------| | list_files | List and search files with filters (path, type, search query, pagination, sort) | | list_folders | List folders at a given path | | get_file_details | Get full metadata for a file (dimensions, tags, URLs, dates) | | upload_file | Upload a local file | | upload_file_from_url | Upload from a remote URL | | upload_base64_file | Upload from base64 data | | delete_file | Delete a file by ID | | create_folder | Create a new folder | | delete_folder | Delete a folder | | move_file | Move a file to a different folder | | generate_url | Generate URLs with transformations (resize, crop, format, signed URLs) |

Examples

Ask your AI assistant:

• "List all images in the /products/ folder"
• "Upload this screenshot to /screenshots/2026/"
• "Generate a 300x300 thumbnail for /hero-banner.jpg"
• "Search for files named 'logo'"
• "Move /old-folder/image.jpg to /new-folder/"
• "Delete the file with ID abc123"

Development

git clone https://github.com/aiconnai/imagekit-mcp-server.git
cd imagekit-mcp-server
npm install

# Set credentials
export IMAGEKIT_PUBLIC_KEY=public_xxx
export IMAGEKIT_PRIVATE_KEY=private_xxx
export IMAGEKIT_URL_ENDPOINT=https://ik.imagekit.io/your_id

# Run
node index.js

License

MIT