Mastodon for Home Assistant (built-in integration)

About

Mastodon is a built-in integration that connects Home Assistant to a Mastodon account. It adds sensors for account details such as followers, following, posts, last post and username. Binary sensors report account flags, including bot, locked, discoverable, indexable, suspended and moved. Actions can post a status, get information about an account, mute or unmute an account, and update the profile information and pictures. It relies on the vendor's cloud and is set up in the UI with an application's access token, client key, client secret and the server URL. Connection settings can be changed later without removing the integration.

Automatic summary of Home Assistant's source code. Something wrong? Get in touch

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
Set up in the UI Add it in Settings, Devices and services. Nothing to download.
Change settings later Its connection settings can change without removing it.
Gold quality Home Assistant's own rating of its code and setup experience.
Updated with Home Assistant Ships and updates with every Home Assistant release.

Provides

Sensors

Setting it up

It is added under Settings, Devices and services, with Add integration.

Connect

Access tokenThe access token for the application created within your Mastodon account.
URL
Client keyThe client key for the application created within your Mastodon account.
Client secretThe client secret for the application created within your Mastodon account.

Sign in again

Access tokenThe access token for the application created within your Mastodon account.

Change the connection

Access tokenThe access token for the application created within your Mastodon account.
Client keyThe client key for the application created within your Mastodon account.
Client secretThe client secret for the application created within your Mastodon account.

Texts from Home Assistant's source code, Apache License 2.0.

Entities

Binary sensorsBot, Discoverable, Indexable, Limited, Locked, Memorial, Moved, Suspended
SensorsFollowers, Following, Last post, Posts, Username

Actions

Get accountGets information about a Mastodon account.Fields: Account name, Mastodon instance
Mute accountMutes a Mastodon account.Fields: Account name, Mastodon instance, Duration, Hide notifications
PostPosts a status on your Mastodon account.Fields: Mastodon account, Content warning, Idempotency key, In reply to, Language, Media, Media description, Media warning, Who can quote, Quote
Unmute accountUnmutes a Mastodon account.Fields: Account name, Mastodon instance
Update profileUpdates your Mastodon profile information and pictures.Fields: Attribution domains, Profile picture, Automated account, Mastodon account, Delete profile picture, Delete header picture, Discoverable, Display name, Extra fields, Header picture