Area: AI Assistant
Path: /assistant
Icon: Sparkle/Assistant icon in the sidebar
Overview
The AI Assistant is an AI-powered chat assistant for calendar, contacts, tasks, and chats (Matrix, Microsoft Teams). It uses your connected data to answer questions and help with planning.
Prerequisites
- Assistant enabled: Settings → AI Assistant → Enable Assistant
- API key: A valid API key for the chosen provider (e.g. OpenAI, Anthropic) configured in settings
Without activation or API key, a corresponding hint message is displayed.
Layout
| Element | Description |
|---|---|
| Header | Assistant name, subtitle (Calendar, contacts, tasks & chats) |
| Model selector | Dropdown to switch LLM provider and model |
| Clear chat | Button to delete conversation history |
| Message area | Chat history (user and assistant messages) |
| Input field | Text input and send button |
Assistant Context
The assistant has access to:
| Data source | Content |
|---|---|
| Calendar | Events for the next 7 days (from connected providers) |
| Contacts | Top 50 contacts (Microsoft, Nextcloud, Open-Xchange) |
| Tasks | Open tasks from Planner/Nextcloud/OX |
| Unread rooms | Matrix chats and MS Teams chats with unread messages |
| Mentions | @Mentions from Matrix and Microsoft Teams |
The time range for calendar and activities can be adjusted under Settings → Notifications and Activity → Activity Time Range (1–90 days).
Example Questions
- "What do I have this week?"
- "Show me my unread chats"
- "When do I have time for a 30-minute meeting?"
- "Who is Anna Schmidt?" (contact search)
- "Which tasks are due?"
- "Create an event tomorrow at 10am"
Write Actions
For event or task creation, the assistant can suggest actions. If Confirm write actions is enabled in settings, you will be asked before creating. Without confirmation, actions are executed directly.
For Planner, the assistant also supports:
- Updating/deleting tasks, assigning or unassigning users, and moving tasks between buckets
- Creating, renaming, and deleting plans
- Listing planner targets (providers, plans, Microsoft groups) before plan operations
For destructive actions (for example delete), keep confirmation enabled.
Settings
All configuration options: Settings → AI Assistant
| Setting | Description |
|---|---|
| Enable Assistant | Turn AI Assistant on or off |
| Agent Name | Name shown in chat header |
| Credential Storage | API key locally or server-side (Proxy) |
| Provider & Model | OpenAI, Anthropic, Google Gemini, IONOS, … |
| API Key | Key for the chosen provider |
| IONOS Contract Number | For multiple IONOS contracts (optional) |
| Response Language | Follow UI language or fixed language |
| Confirm Write Actions | Confirm before event/task creation |
| Scheduled Prompts | Daily/weekly reminders |
LLM Providers and IONOS
Supported providers: OpenAI, Anthropic, Azure OpenAI, Google Gemini, IONOS AI Model Hub, IONOS Teuken, Mistral, Groq, Cohere, DeepSeek, xAI. For IONOS with multiple contracts, enter the contract number in settings (fixes "invalid issuer"). Scheduled Prompts allow daily or weekly reminders (e.g. "What do I have this week?") – configurable in Settings → AI Agent.