telegraph-mcp-py 1.0.0

MCP server for Telegraph API - create and manage Telegraph pages with Claude and other LLM clients

Telegraph MCP Server (Python)

A Model Context Protocol (MCP) server that provides tools for interacting with the Telegraph API (telegra.ph). This Python implementation allows Claude and other LLM clients to create, manage, and export Telegraph pages.

Features

• Account Management: Create accounts, update info, manage access tokens
• Page Operations: Create, edit, retrieve, and list pages
• Template System: Create pages using pre-built templates
• Export & Backup: Export pages to Markdown/HTML, backup entire accounts
• MCP Resources: Access Telegraph pages as MCP resources
• MCP Prompts: Guided workflows for common tasks

Installation

Using uvx (Recommended)

uvx telegraph-mcp-py

Using pip

pip install telegraph-mcp-py

From Source

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

Usage

With Claude Code

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

With Claude Desktop

Add to your Claude Desktop configuration (~/.config/claude/claude_desktop_config.json):

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

Or if installed via pip:

{
  "mcpServers": {
    "telegraph-py": {
      "command": "telegraph-mcp-py"
    }
  }
}

Available Tools

Account Management

Tool	Description
telegraph_create_account	Create a new Telegraph account
telegraph_edit_account_info	Update account information
telegraph_get_account_info	Get account details
telegraph_revoke_access_token	Revoke and regenerate access token

Page Management

Tool	Description
telegraph_create_page	Create a new page (supports HTML/Markdown)
telegraph_edit_page	Edit an existing page
telegraph_get_page	Get page by path
telegraph_get_page_list	List all pages for an account
telegraph_get_views	Get page view statistics

Templates

Tool	Description
telegraph_list_templates	List available templates
telegraph_create_from_template	Create page from template

Export & Backup

Tool	Description
telegraph_export_page	Export page to Markdown/HTML
telegraph_backup_account	Backup all account pages

Resources

Access Telegraph pages directly as MCP resources:

telegraph://page/{path}

Example: telegraph://page/Sample-Page-12-15

Prompts

Pre-defined prompts for guided workflows:

• create_blog_post - Guide for creating blog posts
• create_documentation - Guide for creating documentation
• summarize_page - Summarize an existing page

Examples

Creating a Page with Markdown

# Via MCP tool call
telegraph_create_page(
    access_token="your-token",
    title="My First Post",
    content="# Hello World\n\nThis is my first Telegraph page!",
    format="markdown"
)

Using Templates

telegraph_create_from_template(
    access_token="your-token",
    template="blog_post",
    title="My Blog Post",
    data={
        "intro": "Welcome to my blog!",
        "sections": [
            {"heading": "Section 1", "content": "First section content"},
            {"heading": "Section 2", "content": "Second section content"}
        ],
        "conclusion": "Thanks for reading!"
    }
)

Exporting a Page

telegraph_export_page(
    path="Sample-Page-12-15",
    format="markdown"
)

Development

Setup

cd telegraph-mcp-py
pip install -e ".[dev]"

Testing with MCP Inspector

npx @modelcontextprotocol/inspector uvx telegraph-mcp-py

Related Packages

• telegraph-mcp - TypeScript MCP server
• telegraph-api-py - Python Telegraph client
• telegraph-api-client - TypeScript Telegraph client

License

MIT License - see LICENSE for details.