From d5af629462486d6a9d64537e7a95f3cb5c3874af Mon Sep 17 00:00:00 2001
From: WLTBAgent <agent@wltbagent.dev>
Date: Mon, 23 Feb 2026 19:45:50 +0000
Subject: [PATCH] Document credential separation: Nextcloud Mail uses different
 IMAP/SMTP credentials

---
 CREDENTIALS.md                 | 14 +++++++++++++-
 README.md                      |  7 +++++++
 skills/nextcloud-mail/SKILL.md | 16 ++++++++++++++++
 3 files changed, 36 insertions(+), 1 deletion(-)

diff --git a/CREDENTIALS.md b/CREDENTIALS.md
index 447b1c0..d980b7d 100644
--- a/CREDENTIALS.md
+++ b/CREDENTIALS.md
@@ -10,10 +10,22 @@
 - API Key: Not provided
 - Status: Not provided yet
 
-**Nextcloud System** (current priority):
+## Credentials Provided
+
+### Nextcloud System** (current priority):
 - Server URL: `https://teamworkapps.com`
 - Username: `wltbagent@shortcutsolutions.net`
 - API Key: `1b8a28ca2fc26820fee3f9a8524c351b`
+- **Purpose**: REST API, WebDAV, CalDAV, CardDAV, OCS API endpoints
+
+### Nextcloud Email Integration** (different credentials):
+- **Authentication Method**: IMAP and SMTP (standard mail protocols)
+- **Credentials Available**:
+  - Hostnames (IMAP server, SMTP server)
+  - Username
+  - Password
+- **Purpose**: Email reading/sending via nextcloud-mail integration
+- **Note**: These are separate credentials from the Nextcloud API credentials above
 
 ---
 
diff --git a/README.md b/README.md
index 5ba0d72..128bda8 100644
--- a/README.md
+++ b/README.md
@@ -173,6 +173,13 @@ nextcloud-calendar --op list-events
 
 ### Email (IMAP/SMTP)
 
+**⚠️ Important:** The Nextcloud Mail integration uses **different credentials** from other Nextcloud tools (Files, Contacts, Calendar).
+
+- **Other tools**: Use Nextcloud API credentials (server URL + username + API token)
+- **Mail**: Uses IMAP/SMTP credentials (IMAP hostname, SMTP hostname, username, password)
+
+These are separate authentication systems with different credentials. See `skills/nextcloud-mail/SKILL.md` for details.
+
 ```bash
 # List folders
 nextcloud-mail --op list-folders
diff --git a/skills/nextcloud-mail/SKILL.md b/skills/nextcloud-mail/SKILL.md
index dba40d1..b4fee25 100644
--- a/skills/nextcloud-mail/SKILL.md
+++ b/skills/nextcloud-mail/SKILL.md
@@ -6,6 +6,22 @@
 
 **Server:** https://teamworkapps.com (Nextcloud 25.0.13)
 
+## Important: Separate Credentials
+
+**⚠️ NOTE:** The Nextcloud Mail integration uses **different credentials** from other Nextcloud tools (Files, Contacts, Calendar, etc.).
+
+**Other Nextcloud tools** use:
+- Nextcloud REST API / WebDAV / CalDAV / CardDAV
+- Server: `https://teamworkapps.com`
+- Username: `wltbagent@shortcutsolutions.net`
+- API Key: App token for API access
+
+**Nextcloud Mail** uses:
+- Standard IMAP and SMTP protocols
+- Different hostnames for IMAP/SMTP servers
+- Different username and password
+- These are email credentials, NOT Nextcloud API credentials
+
 ---
 
 ## Bootstrap Process (Automatic)