Claude Bot (2.1.0)

2026-03-28T00:19:26.527024+00:00

Claude Bot for Nextcloud Talk

Chat with Anthropic's Claude AI directly in Nextcloud Talk. Send text, voice messages, or files — Claude responds right in the conversation.

Important: This app alone is only the permission manager!

This Nextcloud app manages who is allowed to use the bot. To actually chat with Claude, you also need to run the Python bot service with Claude Code CLI on a separate machine. Without the bot service, this app does nothing on its own.

What you need (two parts)

1. This Nextcloud app (install on your Nextcloud) — Permission manager: controls which users and groups are allowed to interact with the bot

2. Python bot service + Claude Code CLI (run on any machine) — The actual bot: connects Nextcloud Talk to Claude AI, processes messages and sends responses

Bot service requirements (runs on any machine): - Claude Code CLI installed and authenticated (requires an Anthropic API key) - Python 3.9+ - A dedicated Nextcloud user for the bot (e.g. bot-claude) - Network access to your Nextcloud instance (HTTPS) - The bot service from the GitHub repository

The bot service just needs to reach your Nextcloud via HTTPS — it can run on a laptop, a VPS, a Raspberry Pi, or anywhere else. It logs in as the bot user and polls Nextcloud Talk for new messages.

Features

Text chat — Ask Claude anything, get responses in Talk

Voice messages — Automatically transcribed and answered (optional, requires faster-whisper + GPU)

File attachments — Send images, PDFs, or documents for Claude to analyze

Multi-room — Works in 1:1 chats and group conversations

Per-user sessions — Each user has their own conversation context

User & group permissions — Control who can use the bot via admin UI

Bot commands — /model, /clear, /cost, /effort, /stop, /help

Setup

1. Install this app on your Nextcloud instance

2. Create a Nextcloud user for the bot (e.g. bot-claude)

3. Add allowed users/groups in Settings → Administration → Claude Bot

4. Clone the bot service on your server

5. Install Claude Code CLI and authenticate it

6. Configure and start the bot service (see GitHub README for details)

How it works

User (Talk) → Bot Service → Claude Code CLI → Response back to Talk ↓ Permission check via this app's API

The bot user can be configured via occ config:app:set claudebot bot_user --value="your-bot-user".

Download