View as Markdown
Philips Hue icon

Philips Hue ACTION

Set Light Color

Sets the light color of a Philips Hue light. See the documentation
  • Action
  • Writes data
  • Destructive
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Philips Hue account once, then configure and run Set Light Color 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-set-light-color",
  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.

Set Light Color 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
color Color string
A hexidecimal color value to set the light(s) to. E.g. #800080
Required

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-set-light-color
Version
0.0.2
App
Philips Hue
Authentication
OAuth
Read-only
No
Destructive
Yes
Open world
Yes