View as Markdown
Philips Hue icon

Philips Hue ACTION

Turn Light On

Turns on or off a Philips Hue light or group of lights. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Philips Hue account once, then configure and run Turn Light On from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "philips_hue-turn-light-on",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    philips_hue: { authProvisionId: "apn_xxxxxxx" },
    username: "Username",
    lightId: "Light ID",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Turn Light On inputs
Property Type Description
username Username string
The username to use. See the documentation for information on how to create an authorized username
Required
lightId Light ID string
The identifier of a hue light
Optional Dynamic
groupId Group ID string
The identifier of a hue light group
Optional Dynamic
turnLightOff Turn Light(s) Off boolean
Set to true to turn the light(s) off instead of on
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
philips_hue-turn-light-on
Version
0.0.2
App
Philips Hue
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes