PlugWiki

OCI Cloud MCP Server: Setup for Claude, Cursor and Other Apps

OfficialLocal
GetPyPIoracle.oci-cloud-mcp-serveroracle/mcpDocs
Tools
5
4 read · 1 change
Works in
12
apps
Risk
High
can delete
Auth
API key

Lets your assistant look up and manage Oracle Cloud resources, using your own OCI sign-in.

This is Oracle's general-purpose server for Oracle Cloud Infrastructure (OCI). It gives your assistant five tools to find an OCI SDK call, check what it needs and run it, so one server covers compute, networking, storage and more. It runs on your computer and acts with the permissions of your OCI profile. Oracle lists it among its reference implementations and says the repository is not meant for production use, so start with a low-privilege profile.

Good for

  • Cloud engineers who want to query OCI resources in plain language
  • Developers already using the OCI CLI profile on their machine
  • Teams exploring AI-assisted cloud operations in a test tenancy

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install OCI Cloud MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the OCI Cloud MCP server to Claude Code. Run this command:

claude mcp add oci-cloud -- uvx oracle.oci-cloud-mcp-server

Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires uv (Python).

Built from the package data we hold. Not yet tested by us.

Tools

  • Searches OCI SDK methods by a short keyword like 'list instances'

    Finds the OCI SDK call that matches a short phrase such as 'list instances' or 'create vcn'. It is a keyword match, not a language model, and the README calls it a fallback for when the assistant cannot tell which call to use.

    Try: “Which OCI call lists compute instances?”

    Read · find_oci_api

  • Shows what inputs an OCI operation needs before it is called

    Explains one OCI operation: which inputs are required, which are optional and whether results come in pages. The assistant uses it to build a correct call.

    Try: “What do I need to pass to create a VCN?”

    Read · describe_oci_operation

  • Runs any OCI SDK operation, including ones that create, change or delete resources

    Runs the chosen OCI operation with the inputs you give it and returns a compact result. It can call any public method of any OCI client, so it can create, update and delete resources as well as read them. Nothing in the server limits it to read-only calls.

    Try: “List the running compute instances in my dev compartment and show their names and states.”

    Delete · invoke_oci_api

  • Lists the operations an OCI service client offers, with optional filtering

    Shows what you can do with one OCI service, for example every operation on the compute client. It narrows the search before the assistant picks a call.

    Try: “What operations does the OCI object storage client offer?”

    Read · list_client_operations

  • Used by the assistant behind the scenes

    Lists the OCI service clients installed with the SDK

    Returns the OCI service clients the server can use. It is meant for checking what is available or debugging.

    Try: “Which OCI services can you work with?”

    Read · list_oci_clients

Read from the source code

Permissions

high risk · 4 things to watch

High risk

The server can run any OCI operation your profile allows, including deleting resources, and it has no read-only mode. Use a profile whose IAM policy only allows what you accept, ideally in a test tenancy.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It can run any OCI operation, including deletes

    One tool calls any method in the OCI SDK, so it can terminate instances or delete buckets if your profile allows it. Use a profile with least-privilege IAM policies. github.com

  • No read-only mode

    The server has no switch to block changes. Limit what it can do through the OCI IAM policies on the profile you give it. github.com

  • Oracle calls the repository a reference implementation

    The oracle/mcp README says the servers are for reference and exploration, not production use. Try it in a test tenancy first. github.com

  • HTTP mode adds its own sign-in

    Running it as a network server needs an OCI IAM app and sign-in settings. Each caller acts as their own OCI user. github.com

Technical details
Talks toOracle Cloud service APIs in your region
Sign-in and keysUses your OCI CLI profile (OCI_CONFIG_PROFILE) or another OCI sign-in type you choose; credentials stay on your machine.

Questions

Is the OCI Cloud MCP server official?

Yes. It is published by Oracle in the oracle/mcp repository, which Oracle calls a set of reference implementations. The README says the repository is not intended for production use.

Does it need an API key?

It needs an OCI sign-in, not a separate key. In local mode it uses a profile from your OCI CLI config, and you can name the profile and region with environment variables. See the install box.

Can it delete things in my Oracle Cloud account?

Yes, if your OCI profile allows it. It can call any SDK operation, and there is no read-only option. Restrict the profile's IAM policies to what you want the assistant to do.

Does it run locally or in the cloud?

Locally by default, over stdio on your machine. The README also describes an HTTP mode that uses OCI IAM sign-in, and a container image.

OCI Cloud MCP server vs OCI API MCP server?

Oracle recommends the Cloud server for most people. It calls the OCI Python SDK directly. The API server instead wraps the OCI command line tool, so pick it only if you specifically need CLI commands.

How do I add it to Claude or Cursor?

Use the install box above, pick your app and set your OCI profile name. You need uv installed and an OCI CLI profile already configured.

Information

updated Nov 2, 2026

Publisher
Official
Package
oracle.oci-cloud-mcp-server
Registry
PyPI
Transport
stdio, Streamable HTTP
Auth
API key
License
UPL-1.0
Last commit
Nov 1, 2026

DocsPyPI

Other Oracle MCP servers

See all

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 3
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.