# mcp-drawthings

Connects your coding agent to the Draw Things app on macOS. It handles local text-to-image and image transformation runs using Apple Silicon hardware.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 28
- Author: james-see
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/james-see/mcp-drawthings
- Updated: 2026-01-01
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-drawthings

## What it does

This MCP server acts as an intermediary between LLM assistants and the local Draw Things application on macOS. It converts model instructions into calls against the app's local HTTP API, enabling offline image rendering through Stable Diffusion. Completed outputs are written directly to `~/Pictures/drawthings-mcp` by default.

Four tools are available. You can control resolution dimensions, sampler steps, negative prompts, and guidance scale directly in your chat interface through `check_status`, `get_config`, `generate_image`, and `transform_image`.

Image generation fails immediately if Draw Things is closed or if its HTTP server is turned off. Running this server requires an Apple Silicon Mac and Node.js 18 or above.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-drawthings -- npx -y mcp-drawthings
```

### Codex

**Platform CLI**
```bash
codex mcp add mcp-drawthings -- npx -y mcp-drawthings
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-drawthings": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-drawthings"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-drawthings": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mcp-drawthings"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp-drawthings npx -y mcp-drawthings
```

## When to use it
- render images locally from text prompts
- modify existing graphics using img2img
- inspect loaded model settings in Draw Things
- save generated artwork directly to local disk

## Example prompts
- Generate a picture of a cyberpunk alley in rain at 768x512 resolution
- Transform `sketch.png` with prompt 'watercolor landscape' and denoising 0.6
- Check the Draw Things API status and read the active configuration

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107423
- [Agent Skills Search Server](https://affpapa.org/en/nevibecode/mcp/agent-skills-search-server.md) — MCP server · ★ 26559
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23263
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [PraisonAI](https://affpapa.org/en/nevibecode/mcp/praisonai.md) — MCP server · ★ 9289

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md