# Voice Monkey — Pipedream Connect

> Voice Monkey is a free Skill that allows you to trigger Alexa Routines from external sources such as IFTTT. It also allows you to make dynamic and custom Text to Speech announcements over your Amazon Echo or other Alexa smart speaker.

- API slug: `voice_monkey` (use in MCP headers and tool keys)
- Auth: API key (Pipedream-managed)
- Categories: Productivity
- Website: https://voicemonkey.io/
- This page (HTML): https://pipedream.com/apps/voice-monkey
- Tools: 4 actions · 0 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: voice_monkey`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
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 accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "voice_monkey",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Display Image:
const result = await mcp.callTool({
  name: "voice_monkey-display-image",
  arguments: {
    monkey: "Monkey",
    imageUrl: "Image URL (https://)",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Voice Monkey endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.voicemonkey.io/trigger

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkudm9pY2Vtb25rZXkuaW8vdHJpZ2dlcg?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
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: "voice_monkey-display-image",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    voice_monkey: { authProvisionId: "apn_xxxxxxx" },
    monkey: "Monkey",
    imageUrl: "Image URL (https://)",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (4)

### `voice_monkey-display-image` — Display Image (Write)

This action will display an image on your device with a screen e.g. Echo Show. See docs here

Full schema: https://pipedream.com/apps/voice-monkey/actions/display-image.md

### `voice_monkey-display-video` — Display Video (Write)

This action will display a video on your device with a screen e.g. Echo Show. See docs here

Full schema: https://pipedream.com/apps/voice-monkey/actions/display-video.md

### `voice_monkey-make-annoucement` — Make Announcement (Write)

This action will make an annoucement on your device using the text you supply. See docs here

Full schema: https://pipedream.com/apps/voice-monkey/actions/make-annoucement.md

### `voice_monkey-trigger-monkey` — Trigger Monkey (Write)

This action will make an annoucement on your device using any parameters you set. See docs here

Full schema: https://pipedream.com/apps/voice-monkey/actions/trigger-monkey.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt