Skip to main content
Glama
chigwell

PyAutoGUI-MCP

by chigwell
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

PyAutoGUI-MCP exposes MCP tools dynamically from the PyAutoGUI API. It does not manually reimplement or wrap each function: it auto-registers the available API.

Install with pip

pip install pyautogui-mcp

Run the server:

pyautogui-mcp --transport stdio
pyautogui-mcp --transport http --host 127.0.0.1 --port 8000

MCP client config example:

{
  "mcpServers": {
    "pyautogui-mcp": {
      "command": "pyautogui-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

Related MCP server: macos-computer-use-mcp

Run with uv

Dependencies are declared in pyproject.toml, so uv can resolve and run directly:

{
  "mcpServers": {
    "pyautogui-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/full/path/to/pyautogui-mcp",
        "run",
        "python",
        "-m",
        "pyautogui_mcp"
      ]
    }
  }
}

You can also launch manually:

uv run python -m pyautogui_mcp --transport stdio
uv run python -m pyautogui_mcp --transport http --host 127.0.0.1 --port 8000

Use in your own project

Import only what you need and run it under your own server lifecycle:

from pyautogui_mcp import mcp, register_pyautogui_api

register_pyautogui_api(prefix="pyautogui_")
mcp.run()  # or mcp.run(transport="http", host="127.0.0.1", port=8000)

Other exports:

from pyautogui_mcp import pyautogui_diagnose, pyautogui_tools

Desktop control notes

  • The server runs actions on the machine where it is launched (current desktop/display).

  • PyAutoGUI requires a real GUI session; headless environments will fail.

  • Safety: moving the mouse to a corner triggers the PyAutoGUI failsafe.

  • Optional pause between actions via PYAUTOGUI_PAUSE=0.1.

Tool examples

Tool names are exposed with the default pyautogui_ prefix (configurable with --prefix).

Tool

Inputs (common)

Output

pyautogui_screenshot

imageFilename (optional), region (optional [left, top, width, height])

MCP image content (PNG bytes)

pyautogui_screenshot_encoded

format (png/jpeg), quality (1-95, JPEG only), region

MCP image content (PNG/JPEG bytes)

pyautogui_position

none

cursor coordinates { "x": int, "y": int }

pyautogui_click

x, y, clicks, button, interval, duration

null (mouse click performed)

pyautogui_doubleClick

x, y, button, interval, duration

null (double-click performed)

pyautogui_rightClick

x, y, interval, duration

null (right-click performed)

pyautogui_moveTo

x, y, duration

null (mouse moved)

pyautogui_moveRel

xOffset, yOffset, duration

null (mouse moved relative)

pyautogui_dragTo

x, y, duration, button

null (drag performed)

pyautogui_dragRel

xOffset, yOffset, duration, button

null (drag performed)

pyautogui_write

message, interval

null (text typed)

pyautogui_typewrite

message, interval

null (text typed)

pyautogui_press

keys, presses, interval

null (key press performed)

pyautogui_hotkey

keys, interval

null (hotkey chord performed)

pyautogui_scroll

clicks, x, y

null (scroll performed)

pyautogui_tools

none

tool list { note, tools:[{name, description}] }

pyautogui_diagnose

none

{ python, platform, deps } diagnostic info

Use pyautogui_tools to list the exact tool set for your environment and PyAutoGUI version.

This server cannot be installed

A
license - permissive license
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
0dRelease cycle
3Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • mcp-autogui-multinode

    stonehill-2345
    A
    license
    -
    quality
    D
    maintenance
    An MCP and HTTP server wrapper for PyAutoGUI that enables LLMs to control mouse and keyboard operations across local or remote distributed environments. It provides comprehensive tools for screen interaction, including clicking, typing, and capturing screenshots.
    19
    MIT

  • macos-computer-use-mcp

    Zooeyii
    F
    license
    A
    quality
    D
    maintenance
    Provides native macOS computer control tools including mouse and keyboard simulation, screenshot capture, and application management for MCP-compatible agents. It enables AI assistants to directly interact with the macOS operating system and installed apps through standard tool calls.
    24
    8

  • atomic-computer-mcp

    Dawdler-G
    F
    license
    -
    quality
    D
    maintenance
    Enables automation of native Windows desktop applications through screen capture, mouse/keyboard control, and waiting for UI changes, exposing them as MCP tools.
    1

View all related MCP servers

Related MCP Connectors

  • Frenchie

    OCR, transcription, file extraction, and image generation for AI agents via MCP.

  • ToolAPI

    Free public MCP for AI agents — 193 tools, 44 workflows. No API key.

  • Vee3

    Hosted MCP with 91 agent tools: X, domains, SEO, Maps, Trends, Search, YouTube, TikTok, and more.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/chigwell/pyautogui-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server