Home Assistant MCP Server

Instructions

Implementation Reference

• src/index.ts:183-200 (handler)

  The main execution logic for the 'trigger_automation' tool. Validates input, calls Home Assistant API to trigger the specified automation, and returns success response.

  private async triggerAutomation(args: any) {
    if (!args.automation_id) {
      throw new McpError(ErrorCode.InvalidParams, 'automation_id is required');
    }
  
    const response = await this.haClient.post('/api/services/automation/trigger', {
      entity_id: args.automation_id,
    });
  
    return {
      content: [
        {
          type: 'text',
          text: `Successfully triggered ${args.automation_id}`,
        },
      ],
    };
  }

• src/index.ts:92-101 (schema)

  JSON Schema defining the input parameters for the tool: requires 'automation_id' as a string.

  inputSchema: {
    type: 'object',
    properties: {
      automation_id: {
        type: 'string',
        description: 'The automation ID to trigger (e.g., automation.morning_routine)',
      },
    },
    required: ['automation_id'],
  },

• src/index.ts:89-102 (registration)

  Registration of the tool in the 'list_tools' response, including name, description, and schema.

  {
    name: 'trigger_automation',
    description: 'Trigger a Home Assistant automation',
    inputSchema: {
      type: 'object',
      properties: {
        automation_id: {
          type: 'string',
          description: 'The automation ID to trigger (e.g., automation.morning_routine)',
        },
      },
      required: ['automation_id'],
    },
  },

• src/index.ts:126-127 (registration)

  Dispatch/route in the 'call_tool' request handler that maps tool name to the handler function.

  case 'trigger_automation':
    return await this.triggerAutomation(request.params.arguments);