telegram-notes-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TG_API_ID | Yes | Your Telegram API ID from my.telegram.org | |
| TG_API_HASH | Yes | Your Telegram API hash from my.telegram.org | |
| TG_BOT_TOKEN | No | Bot token for the bot-message editor (optional) | |
| TG_OLLAMA_URL | No | URL of your Ollama server for semantic search (optional) | http://localhost:11434 |
| TG_EMBED_MODEL | No | Embedding model name for semantic search (optional) | nomic-embed-text |
| TG_OLLAMA_AUTH | No | Authentication token for Ollama if required (optional) | |
| TG_CHAT_WHITELIST | Yes | Comma-separated usernames (e.g., @someone) and/or numeric chat IDs (e.g., -1001234567890); use 'me' for Saved Messages | |
| TG_OWN_BOT_USERNAME | No | Your bot username for analytics noise-filter (optional) |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_messagesC | Full-text search over indexed Telegram messages. |
| list_chatsA | List whitelisted chats with message counts and last activity date. |
| get_chat_contextB | Return messages surrounding a specific message in a chat. |
| semantic_searchA | Поиск сообщений по СМЫСЛУ (эмбеддинги), а не по точным словам. Требует предварительной индексации (embed_index / scripts/embed_backfill.py). Если обучен whitening-индекс (scripts/build_white_index.py) — использует retrieve-more + bge-rerank; иначе честный fallback на сырой nomic. |
| embed_indexA | Проиндексировать (сгенерировать эмбеддинги) одну пачку сообщений без вектора. Вызывать повторно, пока has_more=true. Для полной переиндексации удобнее scripts/embed_backfill.py. |
| sync_nowA | Force an incremental re-sync of all whitelisted chats. |
| transcribe_voicesA | Transcribe pending voice/video-note messages via Telegram's built-in transcription (requires the logged-in account to have Premium). Transcripts are written into messages.text so they flow into search, embeddings, bursts and topics. Returns {total, transcribed, failed}. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/RaspizDIYs/telegram-notes-mcp-public'
If you have feedback or need assistance with the MCP directory API, please join our Discord server