mcp-server

iva-agent

Name: iva-agent
Author: smixs

AI assistant in Telegram that remembers everything and helps you run your life. Self-hosted in one command.

266 stars+17★ this week59 forksTypeScriptUpdated 10/25/2026100% free · open source

What it does

A self‑hosted Telegram bot that acts as a persistent AI assistant, remembering past conversations and helping you manage tasks, notes, and schedules.

When to use it

•You want a private, always‑available AI assistant inside Telegram for yourself or a small team.
•You need a bot that can store context across days (e.g., keep meeting notes, to‑do lists, or personal reminders).
•You prefer not to rely on third‑party SaaS bots and are comfortable running a single Docker container.

Ready-to-paste prompt

/remember I need to review the Q3 budget on Thursday at 2 PM and send the updated deck to the board.

Heads up: The container won’t start without both TELEGRAM_BOT_TOKEN and OPENAI_API_KEY environment variables; missing or invalid keys cause the bot to crash on first message.

Saves to your device

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🔑 Needs an API key

Works after you add credentials — the setup agent will ask you for them.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/iva-agent && curl -fsSL https://workflowstacks.com/api/skills/iva-agent/claude-skill -o ~/.claude/skills/iva-agent/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How iva-agent works

Codeflow

Free to inspect

Iva-agent is a very large TypeScript project (~686k lines across 3328 code files, plus 228 test files). Setup is light: installs like a normal app — add your API keys. Reading the code is optional. Last commit this month, MIT license, has a test suite.

Size

Very large codebase

~686k lines · 3328 code files · days to read — use, don't read

Setup

One-command install

Installs like a normal app — add your API keys. Reading the code is optional.

Runs on

Node.js

Needs API keys (.env)

TypeScript 96%MDX 2%TLA 1%Shell 1%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
bin/iva.mjs
Where the program starts running
3
package.json
Dependencies and the commands it exposes
4
.env.example
The API keys and settings you must provide
5
agent/connections/README.md
Inside agent/ — an example of what the AI is told to do

What's in each folder

agent/Prompts, skills & agent definitions292 files

skills/Prompts, skills & agent definitions9 files

services/Backend / API18 files

packages/Sub-packages / plugins13 files

bin/Command-line entry points1 files

docs/Documentation119 files

eve/Folder3015 files

scripts/Helper scripts561 files

READMEHas testsDocumentedNo CIMIT licenseUpdated this month

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🔑 Needs an API key

Works after you add credentials — the setup agent will ask you for them.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/iva-agent && curl -fsSL https://workflowstacks.com/api/skills/iva-agent/claude-skill -o ~/.claude/skills/iva-agent/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

Quick Actions

Details

Creator

smixs

Language

TypeScript

Do this with a working workflow

Pages we wrote and tested that put a skill like this to work — importable n8n templates, outcome guides and Claude Desktop configs.

MCP config

Memory (knowledge graph) MCP config

Persistent memory across chats via a local knowledge graph.

Free n8n template

AI Support Agent (Chat)

A chat agent that answers customer questions from YOUR business info — with conversation memory. It never invents policies; anything it doesn't know, it hands to a human.