Tapo MCP

Name: Tapo MCP
Author: mihai-dinculescu

Community

MCP server by mihai-dinculescu · updated 4 days ago · ★ 860

Score 87

MCP server for discovering and controlling TP-Link Tapo smart home devices via AI Agents Tapo MCP is a community project by mihai-dinculescu, not verified by a company domain.

Install Add to Cursor Add to VS Code GitHub

Yours? Claim it

Works withClaude Code Claude Desktop Cursor Codex Gemini CLI VS Code Windsurf Antigravity CLI

Maintenance

Last commit 4 days ago

Licence

MIT: permissive, fine for commercial use

Quality

Clear description, published package or server URL, 860 stars, original repository

Security

No risky patterns in the files we checked

What you need

Setting	Needed	What it is
`TAPO_MCP_USERNAME`Environment variable, secret	Required	TP-Link Tapo account email
`TAPO_MCP_PASSWORD`Environment variable, secret	Required	TP-Link Tapo account password
`TAPO_MCP_DISCOVERY_TARGET`Environment variable	Required	Network target for device discovery (e.g. 192.168.1.255)
`TAPO_MCP_API_KEY`Environment variable, secret	Optional	Optional Bearer token for API authentication
`TAPO_MCP_DISCOVERY_TIMEOUT`Environment variable	Optional	Device discovery timeout in seconds Default: `5`
`OTEL_EXPORTER_OTLP_ENDPOINT`Environment variable	Optional	Optional OpenTelemetry collector endpoint for tracing

From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.

Install Tapo MCP

Built from the published package, never by AI

claude mcp add tapo-mcp -e TAPO_MCP_USERNAME=YOUR_TAPO_MCP_USERNAME -e TAPO_MCP_PASSWORD=YOUR_TAPO_MCP_PASSWORD -e TAPO_MCP_DISCOVERY_TARGET=YOUR_TAPO_MCP_DISCOVERY_TARGET -- docker run -i --rm -e TAPO_MCP_USERNAME -e TAPO_MCP_PASSWORD -e TAPO_MCP_DISCOVERY_TARGET ghcr.io/mihai-dinculescu/tapo-mcp:0.5.3

Run in your terminal. Add --scope user to use it in every project.

Step-by-step: install Tapo MCP in Claude Code

{
  "mcpServers": {
    "tapo-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TAPO_MCP_USERNAME",
        "-e",
        "TAPO_MCP_PASSWORD",
        "-e",
        "TAPO_MCP_DISCOVERY_TARGET",
        "ghcr.io/mihai-dinculescu/tapo-mcp:0.5.3"
      ],
      "env": {
        "TAPO_MCP_USERNAME": "YOUR_TAPO_MCP_USERNAME",
        "TAPO_MCP_PASSWORD": "YOUR_TAPO_MCP_PASSWORD",
        "TAPO_MCP_DISCOVERY_TARGET": "YOUR_TAPO_MCP_DISCOVERY_TARGET"
      }
    }
  }
}

Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.

Step-by-step: install Tapo MCP in Claude Desktop

{
  "mcpServers": {
    "tapo-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TAPO_MCP_USERNAME",
        "-e",
        "TAPO_MCP_PASSWORD",
        "-e",
        "TAPO_MCP_DISCOVERY_TARGET",
        "ghcr.io/mihai-dinculescu/tapo-mcp:0.5.3"
      ],
      "env": {
        "TAPO_MCP_USERNAME": "YOUR_TAPO_MCP_USERNAME",
        "TAPO_MCP_PASSWORD": "YOUR_TAPO_MCP_PASSWORD",
        "TAPO_MCP_DISCOVERY_TARGET": "YOUR_TAPO_MCP_DISCOVERY_TARGET"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).

Step-by-step: install Tapo MCP in Cursor

{
  "servers": {
    "tapo-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TAPO_MCP_USERNAME",
        "-e",
        "TAPO_MCP_PASSWORD",
        "-e",
        "TAPO_MCP_DISCOVERY_TARGET",
        "ghcr.io/mihai-dinculescu/tapo-mcp:0.5.3"
      ],
      "env": {
        "TAPO_MCP_USERNAME": "YOUR_TAPO_MCP_USERNAME",
        "TAPO_MCP_PASSWORD": "YOUR_TAPO_MCP_PASSWORD",
        "TAPO_MCP_DISCOVERY_TARGET": "YOUR_TAPO_MCP_DISCOVERY_TARGET"
      }
    }
  }
}

Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".

Step-by-step: install Tapo MCP in VS Code

codex mcp add tapo-mcp --env TAPO_MCP_USERNAME=YOUR_TAPO_MCP_USERNAME --env TAPO_MCP_PASSWORD=YOUR_TAPO_MCP_PASSWORD --env TAPO_MCP_DISCOVERY_TARGET=YOUR_TAPO_MCP_DISCOVERY_TARGET -- docker run -i --rm -e TAPO_MCP_USERNAME -e TAPO_MCP_PASSWORD -e TAPO_MCP_DISCOVERY_TARGET ghcr.io/mihai-dinculescu/tapo-mcp:0.5.3

Step-by-step: install Tapo MCP in Codex

{
  "mcpServers": {
    "tapo-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TAPO_MCP_USERNAME",
        "-e",
        "TAPO_MCP_PASSWORD",
        "-e",
        "TAPO_MCP_DISCOVERY_TARGET",
        "ghcr.io/mihai-dinculescu/tapo-mcp:0.5.3"
      ],
      "env": {
        "TAPO_MCP_USERNAME": "YOUR_TAPO_MCP_USERNAME",
        "TAPO_MCP_PASSWORD": "YOUR_TAPO_MCP_PASSWORD",
        "TAPO_MCP_DISCOVERY_TARGET": "YOUR_TAPO_MCP_DISCOVERY_TARGET"
      }
    }
  }
}

Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).

Step-by-step: install Tapo MCP in Antigravity CLI

gemini mcp add tapo-mcp docker run -i --rm -e TAPO_MCP_USERNAME -e TAPO_MCP_PASSWORD -e TAPO_MCP_DISCOVERY_TARGET ghcr.io/mihai-dinculescu/tapo-mcp:0.5.3

Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.

Step-by-step: install Tapo MCP in Gemini CLI

MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the tapo-mcp block.

Weekly newsletter

Like Tapo MCP? Get the best new MCP servers every week

The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.

Security check

No download-and-run commands, hidden instructions or signs of sending keys out were found.

Checked automatically: README.md. This looks for known risky patterns and is not a full audit. How grades work

Alternatives to Tapo MCP

All alternatives →

Harness autonomous-ai

Start Claude Code and Codex agents the person can watch, wait for them and read their answers.

AAA Local 1.3k

MCP Registry Server modelcontextprotocol

Publish and discover MCP servers via the official MCP Registry. Powered by HAPI MCP server.

AFA Remote 7.4k

ref-tools-ref-tools-mcp ref-tools

Provide your AI coding tools with token-efficient access to up-to-date technical documentation for…

AAA Remote 1.2k

Microsoft Learn MCP MicrosoftDocs

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

ACA Remote 1.9k

Postman MCP Server postmanlabs

Give your AI agents trusted access to the full Postman platform.

AAB Local and remote 8.5k/wk

Agent-Native DesignBuilderIO

Agent-Native design tool - create and edit visual designs with agent assistance

AAA Remote 7.4k

Tapo MCP vs Harness Tapo MCP vs MCP Registry Server Tapo MCP vs ref-tools-ref-tools-mcp

Tapo MCP: common questions

How do I install Tapo MCP?

In Claude Code run claude mcp add tapo-mcp -e TAPO_MCP_USERNAME=YOUR_TAPO_MCP_USERNAME -e TAPO_MCP_PASSWORD=YOUR_TAPO_MCP_PASSWORD -e TAPO_MCP_DISCOVERY_TARGET=YOUR_TAPO_MCP_DISCOVERY_TARGET -- docker run -i --rm -e TAPO_MCP_USERNAME -e TAPO_MCP_PASSWORD -e TAPO_MCP_DISCOVERY_TARGET ghcr.io/mihai-dinculescu/tapo-mcp:0.5.3. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.

Is Tapo MCP the official server?

Tapo MCP is a community project by mihai-dinculescu, not verified by a company domain.

Is Tapo MCP free?

The code is published under the MIT licence. The service it connects to may have its own pricing.

Is Tapo MCP safe to use?

It scores 87 of 100. Grades: maintenance A, licence A, quality A. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.

What are alternatives to Tapo MCP?

Does Tapo MCP work with ChatGPT?

Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.