System actions

6 actions. Each action calls the same API route with the same scopes on every surface.

integration_accounts

List Connected Accounts.

Route	GET /api/v1/system/integrations/accounts
Tool name	calternal_api_integration_accounts
Surfaces	cli, mcp, webmcp
Scopes	data
Effect	read only
Encoding	request none, response json

calternal action run integration_accounts --input '{}' --json

integration_create_account

Create a Connected Account. Body fields: app_password, caldav_endpoint, calendar_enabled, carddav_endpoint, email, imap_host, mail_enabled, provider, smtp_host, username..

Route	POST /api/v1/system/integrations/accounts
Tool name	calternal_api_integration_create_account
Surfaces	cli, mcp, webmcp
Scopes	data
Effect	destructive, needs --confirm
Encoding	request json, response json

body

Field	Type	Required	Description
app_password	string	yes
caldav_endpoint	string | null	no
calendar_enabled	boolean | null	no	Initial Calendar state; missing means on after successful discovery (#407, DESIGN §49).
carddav_endpoint	string | null	no
email	string	yes
imap_host	string | null	no	Accept host overrides only for Other (#407, DESIGN §49).
mail_enabled	boolean | null	no	Initial Mail state; missing means on for older clients (#407, DESIGN §49).
provider	"icloud" | "fastmail" | "gmail" | "yahoo" | "other"	yes	Providers supported by the shared account setup flow (#407, DESIGN §49).
smtp_host	string | null	no
username	string	yes

calternal action run integration_create_account --input '{}' --confirm --json

integration_delete_account

Delete a Connected Account.

Route	DELETE /api/v1/system/integrations/accounts/{id}
Tool name	calternal_api_integration_delete_account
Surfaces	cli, mcp, webmcp
Scopes	data
Effect	destructive, needs --confirm
Encoding	request none, response json

path

Field	Type	Required	Description
id	string	yes

calternal action run integration_delete_account --input '{"path":{"id":"<id>"}}' --confirm --json

integration_legacy_migration_status

Report legacy account migration.

Route	GET /api/v1/system/integrations/legacy-migration
Tool name	calternal_api_integration_legacy_migration_status
Surfaces	cli, mcp, webmcp
Scopes	data
Effect	read only
Encoding	request none, response json

calternal action run integration_legacy_migration_status --input '{}' --json

integration_update_account

Change Connected Account services. Body fields: calendar_enabled, mail_enabled..

Route	PATCH /api/v1/system/integrations/accounts/{id}
Tool name	calternal_api_integration_update_account
Surfaces	cli, mcp, webmcp
Scopes	data
Effect	destructive, needs --confirm
Encoding	request json, response json

path

Field	Type	Required	Description
id	string	yes

body

Field	Type	Required	Description
calendar_enabled	boolean | null	no
mail_enabled	boolean | null	no

calternal action run integration_update_account --input '{"path":{"id":"<id>"}}' --confirm --json

system_info

Get system information.

Route	GET /api/v1/system/info
Tool name	calternal_api_system_info
Surfaces	cli, mcp, webmcp
Scopes	none
Effect	read only
Encoding	request none, response json

calternal action run system_info --input '{}' --json