Aseprite

How to Set Up and Use Aseprite

The Aseprite MCP Server bridges AI assistants with the Aseprite pixel art application, exposing over 100 tools across 17 categories that cover the full pixel art creation workflow — from drawing individual pixels and shapes to managing animation frames, tweening cels, configuring palettes, applying effects, and exporting sprite sheets. Running as a local Python process that drives Aseprite's scripting API, it allows AI assistants like Claude to create, edit, and animate pixel art through natural language, with support for complex workflows like 4-frame attack animations or full sprite sets. Artists and game developers use it to accelerate pixel art production by describing what they want rather than manually operating every tool.

git clone https://github.com/diivi/aseprite-mcp.git
cd aseprite-mcp

uv sync

# macOS example:
which aseprite
# or:
ls /Applications/Aseprite.app/Contents/MacOS/aseprite

export ASEPRITE_PATH="/Applications/Aseprite.app/Contents/MacOS/aseprite"

{
  "mcpServers": {
    "aseprite": {
      "command": "/opt/homebrew/bin/uv",
      "args": [
        "--directory",
        "/path/to/aseprite-mcp",
        "run",
        "-m",
        "aseprite_mcp"
      ],
      "env": {
        "ASEPRITE_PATH": "/Applications/Aseprite.app/Contents/MacOS/aseprite"
      }
    }
  }
}

{
  "mcpServers": {
    "aseprite": {
      "command": "/opt/homebrew/bin/uv",
      "args": [
        "--directory",
        "/Users/yourname/aseprite-mcp",
        "run",
        "-m",
        "aseprite_mcp"
      ],
      "env": {
        "ASEPRITE_PATH": "/Applications/Aseprite.app/Contents/MacOS/aseprite"
      }
    }
  }
}

- "Draw me a 32x32 pixel art swordsman character"
- "Create a 4-frame sword slash attack animation from windup to follow-through"
- "Make a 16x16 pixel art coin with a gold color palette"
- "Add an outline effect to the sprite on the current layer"
- "Export the current sprite as a PNG sprite sheet with all frames in a row"