Codex is OpenAI's coding agent. It reads, writes, and runs code in your projects from the ChatGPT desktop app or from your terminal with the Codex CLI, and it shares one plugin directory with ChatGPT.
How does the integration work?
Appwrite's official plugin, published in the ChatGPT plugin directory, works in Codex too. It has two parts:
- The hosted Appwrite MCP server. Codex connects to
https://mcp.appwrite.io/and signs you in to your Appwrite account with OAuth. From there it can search the Appwrite documentation, create tables, manage users, and deploy functions and sites in your project. - Thirteen agent skills. Eleven skills cover the Appwrite CLI and the TypeScript, Dart, .NET, Go, Kotlin, PHP, Python, Ruby, Rust, and Swift SDKs. Two more guide Codex through deployments to Appwrite Sites and Appwrite Functions. Codex loads the skills that match your task.
Changes to your project go through a separate write tool that requires confirmation, and each change carries a short reason that appears in your project's Activity tab.
The hosted MCP server authenticates against Appwrite Cloud. If you self-host Appwrite, use the local MCP server instead. It runs on your machine over stdio and connects to your instance with an API key.
How to implement
To use Appwrite in Codex, there are several steps you must complete:
Step 1: Set up your Appwrite project
First, create an account on Appwrite Cloud if you haven't already, and create a project. You don't need an API key: the plugin asks you to sign in to Appwrite after you install it.
Step 2: Install the Appwrite plugin
- Open the ChatGPT desktop app.
- Click Plugins in the sidebar.
- Search for
Appwriteand select the Appwrite plugin. - Click Install plugin.
- Run
codexin your terminal, then run/plugins. - Switch to the OpenAI Curated marketplace.
- Search for
Appwriteand select the Appwrite plugin. - Select Install plugin.
After installation, sign in to Appwrite and authorize access when prompted, then start a new Codex session.
If you installed the earlier plugin from the Appwrite marketplace, it does not include the hosted MCP server. Remove it and the marketplace with:
codex plugin remove appwrite@appwritecodex plugin marketplace remove appwriteStep 3: Connect the MCP server without the plugin (optional)
Skip this step if you installed the plugin. To use only the MCP server, add it from your terminal:
codex mcp add appwrite --url https://mcp.appwrite.io/If Codex does not prompt you to sign in, run codex mcp login appwrite. Manual setup is an alternative to the plugin, not an extra requirement.
Step 4: Test the integration
Try prompts like:
List the projects in my Appwrite accountCreate a new user in my Appwrite projectShow me the tables in my databaseHow do I implement file uploads with Appwrite Storage?
Read more about Codex and Appwrite
If you would like to learn more about Codex and Appwrite, we have some resources that you should visit:
