Skip to content

AI Integration (MCP Server)

ThinkUtils includes a built-in MCP (Model Context Protocol) server that exposes system controls to AI assistants.

AI Integration

What is MCP?

Model Context Protocol is a standard protocol that lets AI assistants interact with external tools. ThinkUtils implements an MCP server so AI tools can monitor and control your ThinkPad settings.

Available Tools

ToolDescription
get_fan_statusFan speed (RPM), level, status
set_fan_speedSet auto, full-speed, or level 0-7
get_cpu_temperatureAll thermal zone readings
get_battery_infoStatus, capacity, health, thresholds
set_battery_thresholdsSet charge start/stop percentages
get_cpu_infoGovernor, frequency, turbo boost
get_memory_infoRAM usage details
get_system_infoHostname, kernel, OS, CPU model

Setup

Start the MCP server from the app's MCP page, then configure your AI tool:

Claude Code

bash
claude mcp add --transport sse thinkutils http://127.0.0.1:8765/sse

Or add to .mcp.json in your project:

json
{
  "mcpServers": {
    "thinkutils": {
      "type": "sse",
      "url": "http://127.0.0.1:8765/sse"
    }
  }
}

Claude Desktop

Add to ~/.config/Claude/claude_desktop_config.json:

json
{
  "mcpServers": {
    "thinkutils": {
      "url": "http://127.0.0.1:8765/sse"
    }
  }
}

Cursor

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

json
{
  "mcpServers": {
    "thinkutils": {
      "url": "http://127.0.0.1:8765/sse"
    }
  }
}

Windsurf

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

json
{
  "mcpServers": {
    "thinkutils": {
      "url": "http://127.0.0.1:8765/sse"
    }
  }
}

LM Studio

Add to ~/.lmstudio/mcp.json:

json
{
  "mcpServers": {
    "thinkutils": {
      "url": "http://127.0.0.1:8765/sse"
    }
  }
}

Or in the app: switch to the Program tab, click Install, then Edit mcp.json.

ChatGPT Desktop

In ChatGPT Desktop, click your profile > Settings > Connectors > Advanced settings, enable Developer mode, then go back to Connectors and click Create:

  • Name: ThinkUtils
  • Server URL: http://127.0.0.1:8765/sse

INFO

Requires ChatGPT Desktop with MCP support (Plus/Team/Enterprise).

Other Tools

For any MCP-compatible client, configure an SSE server with URL http://127.0.0.1:8765/sse.

Released under the LGPL v3 License.