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.

Servidor MCP Tkinter

Potencia tu agente

Añadir este servidor

Install from the publisher. Not a PlugMCP endpoint.

Ejecutar en PlugMCP

Host a copy with our keys and logs.

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

Ejecutar en PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Abrir

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

Añadir este servidor

Host a copy with our keys and logs.

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