How do I install Tkinter?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Tkinter need an API key?

No required environment variable is listed on this record.

What transport does Tkinter use?

Tkinter runs locally over stdio.

When was Tkinter last checked?

Last checked 2026-10-28. A Model Context Protocol (MCP) server that enables AI agents (like Claude) to view, introspect, and control Tkinter GUIs. Features widget-tree extraction and window-specific screenshots.

Tkinter MCP 伺服器

接入你的智能体

新增此伺服器

Install from the publisher. Not a PlugMCP endpoint.

在 PlugMCP 上執行

用我們的金鑰與日誌託管一份副本。

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

在 PlugMCP 上執行

用我們的金鑰與日誌託管一份副本。

这是你新建的服务器，不是此条目的官方端点。若要用发布方的 URL 与凭证，请使用上方安装面板。

啟動

Server facts

Local

Transport: stdio
License: MIT
Last checked: 2026-10-28

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

tkinter-mcp

MCP server for inspecting and automating Tkinter GUI applications.

Overview

An MCP server that enables AI agents to launch, inspect, and interact with Tkinter applications. The server auto-injects an inspection agent via monkey-patching. No modifications to target apps required.

Demo

Tools

Tool	Description
`launch_app`	Start a Tkinter app with inspection enabled
`is_connected`	Check if an app is currently connected
`get_ui_layout`	Get the widget tree as structured JSON
`view_application`	Capture a high-quality JPEG screenshot
`view_application_thumbnail`	Capture a small thumbnail screenshot
`get_window_info`	Get window position and dimensions
`click_widget`	Click a widget (left/right/middle, single/double)
`type_text`	Type text into Entry or Text widgets
`get_widget_by_text`	Find a widget by its text content
`focus_widget`	Set keyboard focus to a widget
`get_focused_widget`	Get the currently focused widget
`get_widget_value`	Get widget value (Entry, Text, Scale, Checkbox, etc.)
`set_widget_value`	Set widget value based on widget type
`get_widget_options`	Get options for Combobox or Listbox
`drag_widget`	Drag and drop between two widgets
`close_app`	Terminate the application

Installation

uvx (Quick Start)

claude mcp add tkinter-mcp-server -- uvx tkinter-mcp-server

Note: Apps using PIL/ImageTk may have compatibility issues with uvx. Use pip install instead.

pip (Recommended for PIL apps)

pip install tkinter-mcp-server
claude mcp add tkinter-mcp-server -- tkinter-mcp-server

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "tkinter": {
      "command": "tkinter-mcp-server"
    }
  }
}

For uvx: use "command": "uvx" with "args": ["tkinter-mcp-server"]

How It Works

The server launches Tkinter apps through a custom launcher that patches tkinter.Tk.__init__. This injects an agent that communicates over a local socket, enabling thread-safe inspection and control of the GUI.

flowchart LR
    A[MCP Client] <--> B[MCP Server]
    B <--> C[Socket]
    C <--> D[Agent]
    D <--> E[Tkinter App]

Requirements

Python 3.10+
macOS, Windows, or Linux

License

MIT

新增此伺服器

用我們的金鑰與日誌託管一份副本。

Server facts

Tools

Questions

How do I install Tkinter?

Does Tkinter need an API key?

What transport does Tkinter use?

When was Tkinter last checked?

Documentation

tkinter-mcp

Overview

Tools

Installation

uvx (Quick Start)

pip (Recommended for PIL apps)

Claude Desktop

How It Works

Requirements

License