infomaniak-tools
Unofficial CLI for Infomaniak Cloud — manage kDrive, kChat, accounts, and more from the terminal. Like gcloud for GCP, but for Infomaniak.
Install
# pip
pip install infomaniak-tools
# with cloud token providers
pip install infomaniak-tools[gcp] # GCP Secret Manager
pip install infomaniak-tools[aws] # AWS Secrets Manager
pip install infomaniak-tools[azure] # Azure Key Vault
pip install infomaniak-tools[all] # all providers
# from source
git clone https://github.com/kilian-lm/infomaniak-tools.git
cd infomaniak-tools && pip install .
Quick start
# configure (interactive — picks your token provider + default drive)
infomaniak configure
# profile & account
infomaniak profile show
infomaniak accounts list
infomaniak accounts products
# kDrive — files & folders
infomaniak drive list
infomaniak drive ls
infomaniak drive ls Documents/Photos
infomaniak drive tree --depth 2
infomaniak drive mkdir Projects/new-project
infomaniak drive upload report.pdf 42
infomaniak drive download 99 ./local-copy.pdf
infomaniak drive search "invoice 2026"
infomaniak drive mv old-folder new-folder
infomaniak drive share create Documents/spec
infomaniak drive trash list
infomaniak drive categories list
infomaniak drive versions my-file.pdf
# kChat — messaging & webhooks
infomaniak chat me
infomaniak chat teams
infomaniak chat channels
infomaniak chat send "deploy complete" --channel CHANNEL_ID
infomaniak chat posts CHANNEL_ID
infomaniak chat webhooks
infomaniak chat webhook-create --channel CHANNEL_ID
infomaniak chat webhook-send "alert!" --url WEBHOOK_URL
infomaniak chat bots
# teams
infomaniak teams list
infomaniak teams create "engineering"
CLI entry points
The package provides three CLI commands:
| Command | Description |
|---|---|
infomaniak |
Full CLI — all products (profile, drive, chat, teams) |
kdrive |
Legacy kDrive-only CLI (backward compatible) |
kchat-notify |
Send kChat webhook notifications from scripts |
Authentication
Token is resolved in this order:
--tokenflagINFOMANIAK_TOKENenvironment variable- Configured provider (set via
infomaniak configure)
Supported token providers
| Provider | Install | Config key |
|---|---|---|
| Environment variable | (built-in) | env |
| GCP Secret Manager | pip install infomaniak-tools[gcp] |
gcp |
| AWS Secrets Manager | pip install infomaniak-tools[aws] |
aws |
| Azure Key Vault | pip install infomaniak-tools[azure] |
azure |
| System keyring | pip install infomaniak-tools[keyring] |
keyring |
Config is stored at ~/.config/kdrive-cli/config.json.
Create an API token
- Go to https://manager.infomaniak.com
- Profile (top-right) → Developer → API tokens
- Create a token with kDrive + kChat scope
Command reference
Core
| Command | Description |
|---|---|
configure |
Interactive setup |
profile show |
Your profile info |
profile emails |
List email addresses |
profile update --language de |
Update profile fields |
accounts list |
List accounts |
accounts products |
List products (kDrive, kChat, etc.) |
accounts users |
List account users |
teams list |
List teams |
teams create NAME |
Create a team |
teams members TEAM_ID |
List team members |
kDrive
| Command | Description |
|---|---|
drive list |
List accessible drives |
drive ls [PATH] |
List directory contents |
drive tree [PATH] |
Directory tree view |
drive info TARGET |
File metadata (JSON) |
drive mkdir PATH |
Create directory (nested) |
drive upload FILE [DIR] |
Upload file |
drive download TARGET [PATH] |
Download file |
drive search QUERY |
Search by name |
drive mv SRC DST |
Move file/folder |
drive cp SRC DST |
Copy file/folder |
drive rename TARGET NAME |
Rename |
drive rm TARGET |
Trash file/folder |
drive hash TARGET |
Get file hash |
drive trash list|empty|restore|count |
Manage trash |
drive share create|show|delete|list |
Share links |
drive favorites |
List favorites |
drive fav TARGET |
Toggle favorite |
drive categories list|create|delete |
Manage categories |
drive versions TARGET |
List file versions |
drive stats |
Drive statistics |
drive users |
Drive users |
drive activities |
Recent activities |
kChat
| Command | Description |
|---|---|
chat me |
Current user info |
chat teams |
List teams |
chat channels |
List channels |
chat channel CHANNEL_ID |
Channel details |
chat channel-create NAME |
Create channel |
chat channel-search QUERY |
Search channels |
chat channel-members CHANNEL_ID |
List members |
chat posts CHANNEL_ID |
Recent messages |
chat send MESSAGE --channel ID |
Post message |
chat thread POST_ID |
Get thread |
chat search-posts QUERY |
Search messages |
chat pin|unpin POST_ID |
Pin/unpin post |
chat react POST_ID EMOJI |
Add reaction |
chat users |
List users |
chat status [USER_ID] |
Get/set status |
chat webhooks |
List webhooks |
chat webhook-create --channel ID |
Create webhook |
chat webhook-send MSG --url URL |
Send via webhook |
chat bots |
List bots |
chat bot-create USERNAME |
Create bot |
chat emoji |
List custom emoji |
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
infomaniak_tools-0.3.0.tar.gz
(28.5 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file infomaniak_tools-0.3.0.tar.gz.
File metadata
- Download URL: infomaniak_tools-0.3.0.tar.gz
- Upload date:
- Size: 28.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4b08116ecc66e024796436014bfccd33bee52236025b7095d0e073a4502ddcf6
|
|
| MD5 |
7a09639d03a2df18d210173f0676cecf
|
|
| BLAKE2b-256 |
d0af37dc31489c234820a234b87558b7aacd20ce7c62eee1f8471106be1d5ff7
|
File details
Details for the file infomaniak_tools-0.3.0-py3-none-any.whl.
File metadata
- Download URL: infomaniak_tools-0.3.0-py3-none-any.whl
- Upload date:
- Size: 34.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e10815090681eedb3ddd07165246da8932d31ada6a5446907c57642201fbdc97
|
|
| MD5 |
591592a46fb9668e81d6d29e6899ec64
|
|
| BLAKE2b-256 |
ec829c71cce931c010d47e43ffc5d1769a6d7a2b66f78322220061901f51516d
|
