IBM Cloud CLI MCP server
[!License: MIT](https://opensource.org/licenses/MIT) [!MCP](https://modelcontextprotocol.io) [!TypeScript](https://www.typescriptlang.org)
MCP server wrapping the IBM Cloud CLI. Provides 80+ tools covering authentication, resource management, Cloud Foundry, Kubernetes, Container Registry, IAM, catalog, and billing operations.
| Tool | Description |
|---|---|
ibmcloud_login | Login with API key or SSO |
ibmcloud_logout | Logout from IBM Cloud |
ibmcloud_target | Set target region and resource group |
ibmcloud_api | View or set API endpoint |
ibmcloud_regions | List available regions |
ibmcloud_account_show | Show current account details |
ibmcloud_account_list | List accessible accounts |
ibmcloud_config_list | List CLI configuration |
ibmcloud_resource_groups, ibmcloud_resource_group_create, ibmcloud_resource_service_instances, ibmcloud_resource_service_instance, ibmcloud_resource_service_instance_create, ibmcloud_resource_service_instance_delete, ibmcloud_resource_service_instance_update, ibmcloud_resource_service_keys, ibmcloud_resource_service_key, ibmcloud_resource_service_key_create, ibmcloud_resource_service_key_delete, ibmcloud_resource_search, ibmcloud_resource_tags, ibmcloud_resource_tag_attach
ibmcloud_cf_orgs, ibmcloud_cf_spaces, ibmcloud_cf_apps, ibmcloud_cf_app, ibmcloud_cf_push, ibmcloud_cf_start, ibmcloud_cf_stop, ibmcloud_cf_restart, ibmcloud_cf_delete, ibmcloud_cf_logs, ibmcloud_cf_env, ibmcloud_cf_set_env, ibmcloud_cf_scale, ibmcloud_cf_routes, ibmcloud_cf_services, ibmcloud_cf_marketplace, ibmcloud_cf_create_service, ibmcloud_cf_bind_service, ibmcloud_cf_unbind_service
ibmcloud_ks_clusters, ibmcloud_ks_cluster, ibmcloud_ks_cluster_config, ibmcloud_ks_cluster_create, ibmcloud_ks_cluster_delete, ibmcloud_ks_workers, ibmcloud_ks_worker_pools, ibmcloud_ks_worker_pool_create, ibmcloud_ks_worker_pool_resize, ibmcloud_ks_zones, ibmcloud_ks_versions, ibmcloud_ks_flavors
ibmcloud_cr_namespaces, ibmcloud_cr_namespace_add, ibmcloud_cr_images, ibmcloud_cr_image_rm, ibmcloud_cr_quota
ibmcloud_iam_users, ibmcloud_iam_user_invite, ibmcloud_iam_api_keys, ibmcloud_iam_api_key_create, ibmcloud_iam_api_key_delete, ibmcloud_iam_service_ids, ibmcloud_iam_service_id, ibmcloud_iam_service_id_create, ibmcloud_iam_service_id_delete, ibmcloud_iam_service_api_keys, ibmcloud_iam_service_api_key_create, ibmcloud_iam_access_groups, ibmcloud_iam_access_group, ibmcloud_iam_access_group_create, ibmcloud_iam_access_group_users, ibmcloud_iam_access_group_user_add, ibmcloud_iam_access_group_policies, ibmcloud_iam_access_group_policy_create, ibmcloud_iam_roles
ibmcloud_catalog_search, ibmcloud_catalog_service, ibmcloud_catalog_service_plans, ibmcloud_billing_account_usage, ibmcloud_billing_resource_group_usage, ibmcloud_billing_resource_instances_usage, ibmcloud_billing_org_usage
ibmcloud_plugin_list, ibmcloud_plugin_repo_plugins, ibmcloud_plugin_install, ibmcloud_version
Install the IBM Cloud CLI:
curl -fsSL https://clis.cloud.ibm.com/install/osx | sh
npm install
npm run build
{
"mcpServers": {
"ibmcloud": {
"type": "stdio",
"command": "node",
"args": ["/path/to/ibmcloud-mcp/dist/index.js"]
}
}
}
The server wraps the ibmcloud CLI binary, parsing JSON output from each command into structured MCP tool responses. Authentication state is managed by the CLI itself.
src/index.ts # MCP server with 80+ tool definitions
src/cli.ts # IBM Cloud CLI execution wrapper
tsconfig.json # TypeScript configuration
dist/ # Compiled output
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y ibmcloud-mcp-serverMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-expertvagabond-ibmcloud": {
"command": "npx",
"args": [
"-y",
"ibmcloud-mcp-server"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referenceibmcloud-mcp-servernpmio.github.ExpertVagabond/ibmcloud works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.