プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

Telegram (kotlogramme)

作者:J0s3fバージョン 0.11.1i★ 0iパソコンで動くリポジトリ ↗
レジストリ名io.github.J0s3f/kotlogramme

インストール方法

できること

Read and, if allowed, act on your own Telegram account: chats, messages, contacts, files.

作者による原文

  • 接続方法 パソコンで動く
  • アカウントまたはキー キー不要
  • カテゴリ チャット・メール

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア12/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

チェック 3/3 合格 · あなたのパソコンで動きます

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

キー不要、インストール不要 · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

  1. 提供元のインストールファイルをダウンロード

    作者の .mcpb ファイルをダウンロード

    .mcpb ファイルは提供元から直接のもので、当サイトは変更していません

  2. ファイルをダブルクリックし、パソコン版 Claude アプリで Install を押す

  3. 試してみる

    Telegram (kotlogramme) を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Telegram (kotlogramme) を使っていると言うか、回答に Telegram (kotlogramme) のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Telegram (kotlogramme) につなげません

Telegram (kotlogramme) はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Telegram (kotlogramme) につなげるアプリを使う

  • キー不要、インストール不要 · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

B · チャット・メール の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code はまだ Telegram (kotlogramme) につなげません

提供元はパソコン版 Claude アプリ用のインストールファイルしか用意していません

代わりにできること

A · Telegram (kotlogramme) につなげるアプリを使う

  • キー不要、インストール不要 · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

Cursor はまだ Telegram (kotlogramme) につなげません

提供元はパソコン版 Claude アプリ用のインストールファイルしか用意していません

代わりにできること

A · Telegram (kotlogramme) につなげるアプリを使う

  • キー不要、インストール不要 · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

VS Code はまだ Telegram (kotlogramme) につなげません

提供元はパソコン版 Claude アプリ用のインストールファイルしか用意していません

代わりにできること

A · Telegram (kotlogramme) につなげるアプリを使う

  • キー不要、インストール不要 · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Telegram (kotlogramme) を使っている人に聞いてみましょう💬 ディスカッション →

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
接続方法
パソコンで動く
最新バージョンi
0.11.1
レジストリ公開日i
2026年11月8日
コードの最終更新i
2026年11月10日
作者
J0s3f
パッケージ
mcpb: …/kotlogramme-0.11.1-linux-aarch64.mcpb
mcpb: …/kotlogramme-0.11.1-linux-x86_64.mcpb
mcpb: …/kotlogramme-0.11.1-macos-aarch64.mcpb
ウェブサイト
github.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント J0s3f で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:10 日前

  • ✓ 合格

    ライセンスがある

    Apache-2.0を使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

未確認:バージョン付きの npm と PyPI パッケージのみ確認できます

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/j0s3f-kotlogramme.svg)](https://mcp.popnx.com/en/servers/j0s3f-kotlogramme)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

チャット・メールのほかのサーバーとの比較i

  • このカテゴリのほかの2038件のうち0%よりスターが多い
  • このカテゴリのほかの2038件のうち72%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの2038件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Telegram (kotlogramme)は安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は10 日前、最新バージョン(0.11.1)がレジストリに届いたのは12 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにMCPBも必要です。

代わりに使えるものは?

同じカテゴリには:emailmd, Kite Discord Bot Builder, e2a — email for AI agents, Infobip MCP, kernelCAD

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

emailmd

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

作者:anypost広く使われている↓ 5432/週★ 13956 日前更新

パソコンでもクラウドでも✓ 提供元 · emailmd.dev

Infobip MCP

Infobip MCP server for omnichannel communication and messaging. SMS, RCS, WhatsApp, Viber and more.

作者:infobip初期★ 3613 か月前更新

クラウドで動く✓ 提供元 · infobip.com

kernelCAD

CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.

作者:w1ne初期★ 3524 日前更新

クラウドで動く✓ 提供元 · kernelcad.com
似たものと比べる
これ
Telegram (kotlogramme)
emailmdKite Discord Bot Buildere2a — email for AI agentsInfobip MCPkernelCAD
動く場所パソコンにインストールが必要クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえはいいいえ
基本チェック3/35/54/44/44/44/4
ライセンスApache-2.0MITAGPL-3.0Apache-2.0MITMIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

kotlogramme-cli

A command-line Telegram client written in Kotlin, built on the kotlogramme facade.

It aims to be two things at once: a genuinely useful, scriptable client for the terminal, and the reference consumer that exercises the whole kotlogramme surface so its gaps are found by a real application.

Status: usable. Phases 1-9 are implemented: authentication, configuration, dialogs, history,

sending and editing, media and files, contacts, search, chat members, dialog folders, live

updates, an interactive shell, admin rights, stickers and inline. The current release is

v0.11.1, carrying the fat jar and

the distribution; it builds on the kotlogram v0.9.15 tag from JitPack. Later additions beyond

the original phases:

download-media, list-files with a server-side media-kind filter, and an upload progress bar for

send-file. Received messages render their formatting, and a message's inline bot is

resolved to @username; see docs/features.md for what ships and

docs/plan.md for what is left (album sends, chunked download with a progress view,

blocking, and the bot-safe numeric peer lookup).

Quick start

kotlogramme config set --api-id <id> --api-hash <hash>   # from my.telegram.org

kotlogramme login --phone +491700000000 # prompts for the code, then 2FA if set kotlogramme dialogs --limit 20 kotlogramme history @some_chat --limit 50 kotlogramme send @some_chat "hello from the terminal" kotlogramme send-file @some_chat clip.mp4 # detects the kind: a streamable video kotlogramme send-file @some_chat clip.mp4 --no-detect # ...or send the raw bytes as a document cat photo.png | kotlogramme send-file @some_chat - --name photo.png # ...or pipe the bytes on stdin kotlogramme list-files @some_chat --kind video # the chat's videos, filtered by Telegram kotlogramme download-media @some_chat 12345 # save a message's media, named after it kotlogramme stickers # installed sticker sets kotlogramme listen # follow new messages kotlogramme shell # interactive REPL

listen [--once] [--all] [--json] [--chat ] follows the live update stream. Read receipts, contact status and other updates without a message are hidden unless --all is given, and then print their content as JSON. --chat shows only messages from that chat, so listen --once --chat @ada waits for the next message there. --once stops after the first shown update, --json prints one object per line, and Ctrl-C ends the command cleanly. The stream is followed on the library's own background update loop, which polls in short waits and joins its thread on stop, so a stop costs at most one of those short polls rather than the library's 30 s one.

list-files lists a chat's files, filtered by media kind on Telegram's side rather than by scanning history, so it reaches the whole chat and not just the part a history read has covered. --kind names the filter (photo, video, photo-video, document, audio, voice, gif, animation), --limit caps the page, and --total prints just how many files the chat holds.

download-media [ ] writes a message's media to a local file. Without a target the file is named after the media's own name, falling back to the message id, and lands in the working directory; missing parent directories are created and an existing file is overwritten. The command prints the path and the byte count, so a script can read either.

Every command renders as a table by default. The global --plain and --json options, which go before the command (kotlogramme --json history @ada), switch one run to tab-separated plain text or to JSON, and --table forces the table; config set --format stores the default. In JSON every output line is one JSON value: a table is an array of objects, a statement is {"message": "..."}, a count is {"count": N}, and a listing cut short ends with {"next_after": "..."}. import-contacts --from-json FILE (- for stdin) takes a JSON array of {"phone", "first_name", "last_name"} objects. Tables wrap to the width of the terminal; --table-width N before the command sets the width yourself (0 never wraps), which is also how to get a wrapped table into a file. kotlogramme doctor checks the installation: the native library, the Telegram schema, the terminal libraries, the configuration and the network, without needing API credentials, and the account too when they are set.

Use it from an AI application (MCP)

kotlogramme mcp runs the client as a Model Context Protocol server over stdin and stdout. Log in once with kotlogramme login, then register the command with your AI application, for example in Claude Desktop's claude_desktop_config.json:

{ "mcpServers": { "telegram": {

"command": "C:\\Tools\\console\\kotlogramme.exe", "args": ["mcp"], "env": { "TG_API_ID": "...", "TG_API_HASH": "..." } } } }

or claude mcp add telegram -- kotlogramme mcp for Claude Code. By default it is read only: it can list chats, read and search messages, list contacts, members and sessions, and wait for the next message. --access read-write adds sending, editing, forwarding, reacting and pinning; --access full adds deleting, removing and blocking people, changing admin rights and ending sessions. An AI application that can write acts as you and reaches real people, so choose the lowest level that does the job. --files-dir adds tools that send files from that directory and save downloads into it, and nothing outside it. Message texts come from other people, so the server tells the model to treat them as data, not as instructions. The tools are listed in docs/features.md.

AI agents: to download and install the server for a person, follow docs/agent-install.md.

Upload progress

send-file draws a one-line progress bar while the bytes go out, showing the percentage, the bytes sent so far, the total and the current rate:

kotlogramme send-file @some_chat clip.mp4

The bar is on by default when the output is a terminal, and off when it is piped or redirected, so a script gets no carriage returns in its output. --progress forces it on and --no-progress turns it off; --no-progress wins if both are given, exactly as --no-color wins over --color. Only send-file uploads bytes, so only send-file has these flags. With --no-color the bar is plain ASCII. An upload that finishes before the first tick draws nothing at all, and the line is erased whether the upload finished, failed or was interrupted with Ctrl-C.

Piped input is spooled to a temporary file before the upload starts, because Telegram has to be told the total before the first part is sent and a pipe carries no length. The spool file is what makes a cat photo.png | kotlogramme send-file @some_chat - upload the exact bytes that were piped, and it also gives the bar a real total, so a piped upload gets a percentage too. The spool file is deleted once the upload ends, whichever way it ended. The one cost is that the bytes pass through the system's temporary directory once: that costs disk I/O rather than memory, and the upload itself still streams in chunks rather than holding the whole file in the heap.

Getting the client

The current release is v0.11.1. Its GitHub Release carries the JVM artifacts below and five single-file native executables:

  • `kotlogramme-all.jar` - a single runnable fat jar. Run it with JDK 25:
  java -jar kotlogramme-all.jar --help
  • `kotlogramme-0.11.1.zip` - the distZip distribution. Unpack it and run kotlogramme-0.11.1/bin/kotlogramme (or kotlogramme-0.11.1\bin\kotlogramme.bat on Windows); the jar and its dependencies live in lib/.
  • Single-file native executables — kotlogramme-0.11.1-windows-x86_64.exe and kotlogramme-0.11.1-{linux,macos}-{x86_64,aarch64}. Run the downloaded file directly; on Linux/macOS first use chmod +x. These require no JRE, JDK or installer. Support libraries are embedded by Wrappe and extracted into a temporary cache. See native requirements.

Requirements

  • JDK 25 to run the JVM distributions; native executables require no Java. Every library below, and the native Telegram library for the host, are bundled into the distribution. Gradle can fetch the JDK automatically via the toolchain resolver when building.
  • Telegram API credentials: an api_id and api_hash from https://my.telegram.org, set with kotlogramme config set or the TG_API_ID/TG_API_HASH environment variables.
  • A Telegram account to sign in with (kotlogramme login), or a bot token. Reading dialogs, history and a chat's files needs an ordinary account.
  • A supported platform: Windows, Linux or macOS on x86_64 or aarch64.
  • Network access to Telegram.
Dependencies

The client is built from these libraries. The distribution is self-contained - they are all bundled into kotlogramme-all.jar, so none has to be installed - and each keeps its own licence.

  • com.github.J0s3f:kotlogram - the facade this client exercises, pinned by tag (see Picking the facade version); it carries grammers and the six native Telegram libraries.
  • Clikt 5.1.0 - command-line parsing, options and help.
  • JLine 4.4.6 - the interactive shell, completion and terminal output.
  • kotlinx.serialization 1.11.0 (JSON) - the --json output format and the configuration file.
  • SLF4J 2.0.20 (simple binding) - logging, quiet unless a level is set.

Build and run

./gradlew build          # compile and run the offline test suite

./gradlew installDist # build the runnable distribution build/install/kotlogramme/bin/kotlogramme --help

On Windows, use gradlew.bat and the generated build\install\kotlogramme\bin\kotlogramme.bat.

Standalone GraalVM builds packed with Wrappe run without a JRE or JDK on Windows x86_64 and Linux/macOS x86_64 and ARM64:

.\scripts\build-native-windows.ps1

build\distributions\kotlogramme-0.1.0-SNAPSHOT-windows-x86_64.exe --help

The script uses C:\Tools\graalvm-jdk-25.0.4+7.1 by default. Building also needs the MSVC C++ tools and Windows SDK. It compiles the native client and uses Wrappe to create and test one portable executable. CI uses Liberica NIK 25 on all five native targets; releases contain their single-file executables alongside the bundled jar and Java zip. Windows ARM64 uses the JVM distribution. See docs/native-image.md for setup, platform requirements and verification.

Picking the facade version

The client depends on the facade's v0.9.15 tag, resolved from JitPack. To pin a different one, pass it explicitly - any published facade tag works:

./gradlew test -PkotlogrammeVersion=<tag>

Documentation

冒頭だけを表示しています。続きはリポジトリで読めます