| name | image-upload |
| description | Upload images to hosting providers and get shareable URLs |
Upload local images to various image hosting providers and get shareable URLs in multiple formats.
Just tell Claude to upload an image:
Upload this image: /path/to/screenshot.png
Claude will upload it to the default provider (Catbox) and return the URL.
Upload /tmp/screenshot.png
Upload /path/to/image.jpg as "my-screenshot"
Upload /path/to/photo.png to imgur
Upload this image and give me the markdown: /path/to/diagram.png
| Provider | Max Size | Config Required | Best For |
|---|---|---|---|
| Catbox | 200MB | No | Default, anonymous, permanent |
| ImgBB | 32MB | API Key | Reliable, good API |
| Imgur | 20MB | Client-ID | Popular, widely supported |
| Freeimage | 64MB | API Key | Large files |
| ImgHippo | 50MB | API Key | Alternative option |
| 20MB | Cookies | China users (legacy) |
Catbox.moe works out of the box without any API keys!
Create a .env file in your project or ~/.claude/ directory:
# Use a different default provider
IMAGE_UPLOAD_PROVIDER=imgbb
# Provider API keys
IMGBB_API_KEY=your_key_here
IMGUR_CLIENT_ID=your_client_id
FREEIMAGE_API_KEY=your_key
IMGHIPPO_API_KEY=your_key
The skill returns URLs in multiple formats:
 for documentation<img src="url"> for web pages[IMG]url[/IMG] for forumsimport { uploadImage } from 'image-upload';
const result = await uploadImage('/path/to/image.png', {
provider: 'catbox',
name: 'my-image'
});
console.log(result.url); // https://files.catbox.moe/abc123.png
console.log(result.formatted.markdown); // 
# Install dependencies
cd image-upload && npm install
# Upload an image
npx tsx src/index.ts /path/to/image.png
# With options
npx tsx src/index.ts /path/to/image.png --provider imgur --name screenshot
The skill handles common errors gracefully: