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 postscreate_documentation- Guide for creating documentationsummarize_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.