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

imagekit-mcp-server

Quick Install