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

Related MCP server: Telegram MCP Server

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

Page Management

Templates

Export & Backup

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.