Telegraph MCP Server

An MCP (Model Context Protocol) server that exposes the Telegraph API as tools for Claude and other LLM clients. This allows AI assistants to create, edit, and manage Telegraph pages programmatically.

Related Projects

This is part of the Telegraph tools ecosystem:

| Project | Description | Package | |---------|-------------|---------| | telegraph-mcp (this) | MCP Server for AI assistants (TypeScript) | | | telegraph-mcp-py | MCP Server for AI assistants (Python) | | | telegraph-js | JavaScript/TypeScript library | | | telegraph-py | Python library | |

Quick Start

npx telegraph-mcp

Or add to Claude Code:

claude mcp add telegraph -- npx telegraph-mcp

Features

• 13 Telegraph API tools covering all Telegraph functionality
• Create and manage Telegraph accounts
• Create, edit, and retrieve Telegraph pages
• View statistics for pages
• Markdown support - Write content in Markdown, automatically converted to Telegraph format
• Templates - Pre-built templates for blog posts, documentation, articles, changelogs, and tutorials
• Export/Backup - Export pages to Markdown or HTML, backup entire accounts
• MCP Resources - Access Telegraph pages as MCP resources
• MCP Prompts - Pre-defined prompts for common tasks

Installation

Option 1: Via npm (Recommended)

# With Claude Code
claude mcp add telegraph -- npx telegraph-mcp

# Or globally
npm install -g telegraph-mcp

Option 2: From Source

git clone https://github.com/NehoraiHadad/telegraph-mcp.git
cd telegraph-mcp
npm install
npm run build
claude mcp add telegraph -- node $(pwd)/dist/index.js

Usage with Claude Code

claude mcp add telegraph -- npx telegraph-mcp

Usage with Claude Desktop

Add this to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "telegraph": {
      "command": "npx",
      "args": ["-y", "telegraph-mcp"]
    }
  }
}

Available Tools

Account Management

| Tool | Description | Auth Required | |------|-------------|---------------| | telegraph_create_account | Create a new Telegraph account | No | | telegraph_edit_account_info | Update account information | Yes | | telegraph_get_account_info | Get account details | Yes | | telegraph_revoke_access_token | Revoke and regenerate access token | Yes |

Page Management

| Tool | Description | Auth Required | |------|-------------|---------------| | telegraph_create_page | Create a new Telegraph page (supports Markdown!) | Yes | | telegraph_edit_page | Edit an existing page | Yes | | telegraph_get_page | Get a page by path | No | | telegraph_get_page_list | List all pages for an account | Yes | | telegraph_get_views | Get view statistics for a page | No |

Templates

| Tool | Description | Auth Required | |------|-------------|---------------| | telegraph_list_templates | List all available page templates | No | | telegraph_create_from_template | Create a page using a template | Yes |

Export & Backup

| Tool | Description | Auth Required | |------|-------------|---------------| | telegraph_export_page | Export a page to Markdown or HTML | No | | telegraph_backup_account | Backup all pages from an account | Yes |

Example Usage

Creating an Account

Use telegraph_create_account with:
- short_name: "MyBot"
- author_name: "AI Assistant"

This returns an access_token that you should save for future operations.

Creating a Page

Use telegraph_create_page with:
- access_token: "your_token_here"
- title: "My First Telegraph Page"
- content: "<p>Hello <b>world</b>!</p><p>This is my first Telegraph page.</p>"

Creating a Page with Markdown

Use telegraph_create_page with:
- access_token: "your_token_here"
- title: "My Markdown Page"
- content: "# Hello World\n\nThis is **bold** and *italic*.\n\n- List item 1\n- List item 2"
- format: "markdown"

Using Templates

Use telegraph_create_from_template with:
- access_token: "your_token_here"
- template: "blog_post"
- title: "My Blog Post"
- data: {
    "intro": "Welcome to my blog!",
    "sections": [
      {"heading": "First Section", "content": "Section content here"}
    ],
    "conclusion": "Thanks for reading!"
  }

Available templates: blog_post, documentation, article, changelog, tutorial

Content Format

The content parameter accepts:

• Markdown (with format: "markdown"): "# Hello\n\n**Bold** and *italic*"
• HTML strings: "<p>Hello <b>world</b></p>"
• JSON Node arrays: [{"tag": "p", "children": ["Hello ", {"tag": "b", "children": ["world"]}]}]

Supported Markdown Syntax

| Syntax | Result | |--------|--------| | # Header | H3 heading | | ## Subheader | H4 heading | | **bold** | Bold text | | *italic* | Italic text | | [text](url) | Link | | ![alt](url) | Image | | - item | Unordered list | | 1. item | Ordered list | | > quote | Blockquote | | `code` | Inline code | | ```code``` | Code block | | --- | Horizontal rule |

Supported HTML Tags

a, aside, b, blockquote, br, code, em, figcaption, figure, h3, h4, hr, i, iframe, img, li, ol, p, pre, s, strong, u, ul, video

Supported Attributes

• href - for <a> tags
• src - for <img>, <video>, <iframe> tags

MCP Resources

Access Telegraph pages as MCP resources:

telegraph://page/{path}

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

MCP Prompts

Available prompts for guided workflows:

| Prompt | Description | |--------|-------------| | create-blog-post | Guide for creating a blog post | | create-documentation | Guide for creating documentation | | summarize-page | Summarize an existing page |

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run directly (for testing)
npm start

Testing with MCP Inspector

npx @modelcontextprotocol/inspector node dist/index.js

API Reference

This server implements all methods from the Telegraph API:

1. createAccount - Create a new Telegraph account
2. editAccountInfo - Update account information
3. getAccountInfo - Get account details
4. revokeAccessToken - Revoke access token
5. createPage - Create a new page
6. editPage - Edit an existing page
7. getPage - Get a page
8. getPageList - Get list of pages
9. getViews - Get page view statistics

License

MIT