# infomaniak-mcp-agent

MCP server connecting AI agents to your Infomaniak account. Helps inspect and control web hosting, kSuite mail, DNS records, and kDrive storage straight from chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: Mogacode-ma
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Mogacode-ma/infomaniak-mcp-agent
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/infomaniak-mcp-agent

## What it does

This server bridges MCP clients with the Swiss cloud provider Infomaniak by pairing the official API with manager proxy routes. It provides 78 tools covering domain management, DNSSEC records, kSuite mailboxes, and storage allocations. Routine maintenance runs in chat without manual dashboard visits.

Safety relies on a two-phase commit mechanism. Destructive actions first produce an execution plan alongside a single-use token valid for 60 seconds. The server requires that token back before applying changes, preventing unintentional edits.

Modifying hosting configurations demands both `INFOMANIAK_SASESSION` and `INFOMANIAK_XSRF_TOKEN` cookies in addition to the standard API token. Missing session cookies will block hosting write calls because the public API alone does not handle them.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `INFOMANIAK_API_TOKEN`, `INFOMANIAK_AUTH_MODE`, `INFOMANIAK_SASESSION`, `INFOMANIAK_XSRF_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env INFOMANIAK_API_TOKEN=<INFOMANIAK_API_TOKEN> --env INFOMANIAK_AUTH_MODE=<INFOMANIAK_AUTH_MODE> --env INFOMANIAK_SASESSION=<INFOMANIAK_SASESSION> --env INFOMANIAK_XSRF_TOKEN=<INFOMANIAK_XSRF_TOKEN> --transport stdio infomaniak-mcp-agent -- npx -y infomaniak-mcp-agent
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add infomaniak-mcp-agent --env INFOMANIAK_API_TOKEN=<INFOMANIAK_API_TOKEN> --env INFOMANIAK_AUTH_MODE=<INFOMANIAK_AUTH_MODE> --env INFOMANIAK_SASESSION=<INFOMANIAK_SASESSION> --env INFOMANIAK_XSRF_TOKEN=<INFOMANIAK_XSRF_TOKEN> -- npx -y infomaniak-mcp-agent
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "infomaniak-mcp-agent": {
            "command": "npx",
            "args": [
                "-y",
                "infomaniak-mcp-agent"
            ],
            "env": {
                "INFOMANIAK_API_TOKEN": "<INFOMANIAK_API_TOKEN>",
                "INFOMANIAK_AUTH_MODE": "<INFOMANIAK_AUTH_MODE>",
                "INFOMANIAK_SASESSION": "<INFOMANIAK_SASESSION>",
                "INFOMANIAK_XSRF_TOKEN": "<INFOMANIAK_XSRF_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "infomaniak-mcp-agent": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "infomaniak-mcp-agent"
            ],
            "env": {
                "INFOMANIAK_API_TOKEN": "<INFOMANIAK_API_TOKEN>",
                "INFOMANIAK_AUTH_MODE": "<INFOMANIAK_AUTH_MODE>",
                "INFOMANIAK_SASESSION": "<INFOMANIAK_SASESSION>",
                "INFOMANIAK_XSRF_TOKEN": "<INFOMANIAK_XSRF_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e INFOMANIAK_API_TOKEN=<INFOMANIAK_API_TOKEN> -e INFOMANIAK_AUTH_MODE=<INFOMANIAK_AUTH_MODE> -e INFOMANIAK_SASESSION=<INFOMANIAK_SASESSION> -e INFOMANIAK_XSRF_TOKEN=<INFOMANIAK_XSRF_TOKEN> infomaniak-mcp-agent npx -y infomaniak-mcp-agent
```
Replace <…> with your own values

## When to use it
- find domains nearing expiration across the account
- add or modify TXT and DKIM DNS records
- create kSuite mailboxes with forwarders
- inspect storage consumption across kDrive instances

## Example prompts
- Check all domains on my Infomaniak account and list those expiring within 60 days.
- Create a new mailbox for support@example.com and route incoming mail to my personal address.
- List my kDrive storage spaces and report how much quota is used.

## Similar
- [createos](https://affpapa.org/en/nevibecode/skills/createos.md) — skill · 1700 installs
- [blitz.cloud](https://affpapa.org/en/nevibecode/mcp/blitzcloud.md) — MCP server
- [zeabur](https://affpapa.org/en/nevibecode/plugins/zeabur.md) — plugin · ★ 39
- [firebase-hosting-basics](https://affpapa.org/en/nevibecode/skills/firebase-hosting-basics.md) — skill · 170300 installs
- [cargo-hosting](https://affpapa.org/en/nevibecode/skills/cargo-hosting.md) — skill · 9800 installs
- [edgeone](https://affpapa.org/en/nevibecode/skills/edgeone.md) — skill · 2200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md