Telegraph

You can run and connect to a Python-based MCP server that lets Claude and other clients interact with telegra.ph (Telegraph). It provides account management, page operations, templates, export, and MCP resources, making it easy to automate Telegraph workflows from your MCP-enabled clients.

How to use

To use this MCP server with an MCP client, install the server, start it, and then connect your client to the provided MCP endpoint using the client’s MCP configuration. You can invoke account and page tools from your client so you can create accounts, manage pages, apply templates, export content, and back up data. The server exposes endpoints and prompts that guide you through common tasks, enabling smooth interaction with Telegraph data through the MCP interface.

How to install

Prerequisites: you need Python installed on your system. You also have the option to run via UVX for streamlined MCP server management, or to install directly with Python’s package installer.

# Install via UVX (recommended)
uvx telegraph-mcp-py

# Or install with Python's package manager
pip install telegraph-mcp-py

# Or install from source
git clone https://github.com/NehoraiHadad/telegraph-mcp
cd telegraph-mcp/telegraph-mcp-py
pip install -e .

Additional steps and configuration

If you are using Claude integration, you can add the MCP server to Claude with the following command to register it for MCP access.

claude mcp add telegraph-py -- uvx telegraph-mcp-py

Configuration for Claude Desktop

You can configure Claude Desktop to connect to the MCP server by adding a server entry in your Claude Desktop configuration.

{
  "mcpServers": {
    "telegraph-py": {
      "command": "uvx",
      "args": ["telegraph-mcp-py"]
    }
  }
}

Additional configuration for local pip install

If you installed the package via pip, you can also reference it directly in your MCP client configuration.

{
  "mcpServers": {
    "telegraph_pyp": {
      "command": "telegraph-mcp-py",
      "args": []
    }
  }
}

Available tools

telegraph_create_account

Create a new Telegraph account.

telegraph_edit_account_info

Update account information.

telegraph_get_account_info

Retrieve account details.

telegraph_revoke_access_token

Revoke and regenerate access tokens.

telegraph_create_page

Create a new Telegraph page with HTML or Markdown content.

telegraph_edit_page

Edit an existing Telegraph page.

telegraph_get_page

Retrieve a page by its path.

telegraph_get_page_list

List all pages for an account.

telegraph_get_views

Get page view statistics.

telegraph_list_templates

List available templates for page creation.

telegraph_create_from_template

Create a page using a predefined template.

telegraph_export_page

Export a page to Markdown or HTML.

telegraph_backup_account

Back up all pages in the account.