Skip to main content
Glama
NehoraiHadad

Telegraph MCP Server (Python)

by NehoraiHadad
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

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

License

MIT License - see LICENSE for details.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/NehoraiHadad/telegraph-mcp-py'

If you have feedback or need assistance with the MCP directory API, please join our Discord server