Installation & Setup

Auto-Install

The fastest way to register QuikGIF with your AI tools:

# Detect and register with all installed clients
quikgif mcp-install

# Skip the confirmation prompt
quikgif mcp-install --yes

# Register with a specific client only
quikgif mcp-install --client cursor

The installer auto-detects which clients are installed by checking for their config files.

Supported Clients

Client	Config File	--client Value
Claude Code	~/.claude.json	claude-code
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json	claude-desktop
Cursor	~/.cursor/mcp.json	cursor
VS Code (Copilot)	~/.vscode/mcp.json	vscode
Windsurf	~/.codeium/windsurf/mcp_config.json	windsurf

Manual Configuration

If you prefer to configure manually, add the following JSON to the appropriate config file for your client.

Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "quikgif": {
      "command": "/opt/homebrew/bin/quikgif",
      "args": ["mcp-server"]
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "quikgif": {
      "command": "/opt/homebrew/bin/quikgif",
      "args": ["mcp-server"]
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "quikgif": {
      "command": "/opt/homebrew/bin/quikgif",
      "args": ["mcp-server"]
    }
  }
}

VS Code (Copilot)

Add to ~/.vscode/mcp.json:

{
  "mcpServers": {
    "quikgif": {
      "command": "/opt/homebrew/bin/quikgif",
      "args": ["mcp-server"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "quikgif": {
      "command": "/opt/homebrew/bin/quikgif",
      "args": ["mcp-server"]
    }
  }
}

tip

Run which quikgif to find the correct binary path. The default Homebrew path is /opt/homebrew/bin/quikgif on Apple Silicon and /usr/local/bin/quikgif on Intel Macs.

Status Check

Verify that QuikGIF is registered with your clients:

quikgif mcp-status

This shows which clients have the QuikGIF MCP server configured and whether the binary path is valid.

Uninstall

Remove QuikGIF from all clients:

# Remove from all clients
quikgif mcp-uninstall

# Remove from a specific client
quikgif mcp-uninstall --client claude-code

Permissions

The MCP server inherits permissions from the quikgif CLI process. You may need to grant:

Screen Recording (Required)

All recording tools require Screen Recording permission. Grant it in System Settings > Privacy & Security > Screen Recording and add the terminal or AI client that runs quikgif.

Accessibility (Optional)

Enables enhanced features:

• Cursor smoothing
• Click indicators
• Keystroke badges
• Type smoothing

Without Accessibility permission, these transforms silently have no effect. Recording and basic rendering work without it.

info

Use the check_permissions tool to verify permission status at any time.