alex/homeassistant-mcp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
d6a5771e01146fd2be051e2afee229d1955d880d
homeassistant-mcp/docs/tools/tools.md
jango-blockchained d6a5771e01 docs: enhance project documentation with comprehensive updates 
- Revamp README.md with improved project overview, architecture diagram, and badges
- Create new development and tools documentation with detailed guides
- Update API documentation with enhanced examples, rate limiting, and security information
- Refactor and consolidate documentation files for better navigation and clarity
- Add emojis and visual improvements to make documentation more engaging
2025-02-04 17:49:58 +01:00

2.8 KiB
Raw Blame History

Home Assistant MCP Tools

This section documents all available tools in the Home Assistant MCP.

Available Tools

Device Management

  1. List Devices

    • List all available Home Assistant devices
    • Group devices by domain
    • Get device states and attributes

  2. Device Control

    • Control various device types
    • Support for lights, switches, covers, climate devices
    • Domain-specific commands and parameters

History and State

  1. History

    • Fetch device state history
    • Filter by time range
    • Get significant changes

  2. Scene Management

    • List available scenes
    • Activate scenes
    • Scene state information

Automation

  1. Automation Management

    • List automations
    • Toggle automation state
    • Trigger automations manually

  2. Automation Configuration

    • Create new automations
    • Update existing automations
    • Delete automations
    • Duplicate automations

Add-ons and Packages

  1. Add-on Management

    • List available add-ons
    • Install/uninstall add-ons
    • Start/stop/restart add-ons
    • Get add-on information

  2. Package Management

    • Manage HACS packages
    • Install/update/remove packages
    • List available packages by category

Notifications

  1. Notify
    • Send notifications
    • Support for multiple notification services
    • Custom notification data

Real-time Events

  1. Event Subscription

    • Subscribe to Home Assistant events
    • Monitor specific entities
    • Domain-based monitoring

  2. SSE Statistics

    • Get SSE connection statistics
    • Monitor active subscriptions
    • Connection management

Using Tools

All tools can be accessed through:

  1. REST API endpoints
  2. WebSocket connections
  3. Server-Sent Events (SSE)

Authentication

Tools require authentication using:

  • Home Assistant Long-Lived Access Token
  • JWT tokens for specific operations

Error Handling

All tools follow a consistent error handling pattern:

{
    success: boolean;
    message?: string;
    data?: any;
}

Rate Limiting

Tools are subject to rate limiting:

  • Default: 100 requests per 15 minutes
  • Configurable through environment variables

Tool Development

Want to create a new tool? Check out:

Examples

Each tool documentation includes:

  • Usage examples
  • Code snippets
  • Common use cases
  • Troubleshooting tips

Support

Need help with tools?