---
title: "Mastodon.py — Mastodon.py 1.8.1 documentation"
description: "!https://mastodonpy.readthedocs.io/en/stable/"
date: 2023-12-21
published: true
tags:
  - python
  - thought
template: link
---


<div class="embed-card embed-card-external">
  <a href="https://mastodonpy.readthedocs.io/en/stable/" class="embed-card-link" target="_blank" rel="noopener noreferrer">
    <div class="embed-card-content">
      <div class="embed-card-title">Mastodon.py — Mastodon.py 2.2.2 documentation</div>
      <div class="embed-card-meta">mastodonpy.readthedocs.io</div>
    </div>
  </a>
</div>


Mastadon.py is a python api client for mastadon that makes it easy to cross post to mastadon.

``` python
from mastodon import Mastodon

Mastodon.create_app(
    'pytooterapp',
    api_base_url = 'https://mastodon.social',
    to_file = 'pytooter_clientcred.secret'
)

from mastodon import Mastodon

mastodon = Mastodon(client_id = 'pytooter_clientcred.secret',)
mastodon.log_in(
    'my_login_email@example.com',
    'incrediblygoodpassword',
    to_file = 'pytooter_usercred.secret'
)

mastodon.toot('Tooting from Python using #mastodonpy !')
```