io.github.chrischall/artsonia-mcp

claude mcp add artsonia-mcp -e 'ARTSONIA_USERNAME=<ARTSONIA_USERNAME>' -e 'ARTSONIA_PASSWORD=<your artsonia_password>' -e 'ARTSONIA_SESSION_CACHE=<ARTSONIA_SESSION_CACHE>' -e 'ARTSONIA_SESSION_FILE=<ARTSONIA_SESSION_FILE>' -e 'ARTSONIA_OUTPUT_DIR=<ARTSONIA_OUTPUT_DIR>' -e 'ARTSONIA_TRANSPORT=<ARTSONIA_TRANSPORT>' -e 'ARTSONIA_WS_PORT=<ARTSONIA_WS_PORT>' -e 'ARTSONIA_INLINE_DOWNLOADS=<ARTSONIA_INLINE_DOWNLOADS>' -- npx -y artsonia-mcp@1.3.3

{
    "mcpServers": {
        "artsonia-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "artsonia-mcp@1.3.3"
            ],
            "env": {
                "ARTSONIA_USERNAME": "<ARTSONIA_USERNAME>",
                "ARTSONIA_PASSWORD": "<your artsonia_password>",
                "ARTSONIA_SESSION_CACHE": "<ARTSONIA_SESSION_CACHE>",
                "ARTSONIA_SESSION_FILE": "<ARTSONIA_SESSION_FILE>",
                "ARTSONIA_OUTPUT_DIR": "<ARTSONIA_OUTPUT_DIR>",
                "ARTSONIA_TRANSPORT": "<ARTSONIA_TRANSPORT>",
                "ARTSONIA_WS_PORT": "<ARTSONIA_WS_PORT>",
                "ARTSONIA_INLINE_DOWNLOADS": "<ARTSONIA_INLINE_DOWNLOADS>"
            }
        }
    }
}

Environment variables

• ARTSONIA_USERNAME Your Artsonia login email address. Required in the default direct mode; not needed when ARTSONIA_TRANSPORT=fetchproxy (the signed-in browser tab carries the session).
• ARTSONIA_PASSWORD secret Your Artsonia account password. Required in the default direct mode; not needed when ARTSONIA_TRANSPORT=fetchproxy.
• ARTSONIA_SESSION_CACHE Set to false to disable the on-disk session cache and re-authenticate on every process start. Defaults to enabled.
• ARTSONIA_SESSION_FILE Absolute path for the session cache file. Defaults to $MCP_DATA_DIR/.artsonia-mcp/session-<user>.json.
• ARTSONIA_OUTPUT_DIR Folders artsonia_download_artwork may save into (a path-delimiter list: ':' on macOS/Linux, ';' on Windows). Unset: ~/Downloads and ~/Pictures, or $MCP_DATA_DIR/downloads when MCP_DATA_DIR is set. Any other dest is refused.
• ARTSONIA_TRANSPORT fetch (default) logs in directly with ARTSONIA_USERNAME/ARTSONIA_PASSWORD; fetchproxy is the optional fallback that rides your signed-in artsonia.com browser tab.
• ARTSONIA_WS_PORT fetchproxy WebSocket port override (default 37149, a shared fleet port). Only used when ARTSONIA_TRANSPORT=fetchproxy.
• ARTSONIA_INLINE_DOWNLOADS 1/true/yes/on returns artsonia_download_artwork images inline as base64 image blocks instead of writing them to disk (for hosted deployments); unset/false saves to disk.