Skip to content
Open
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
---
layout: post
title: "Introducing the Appwrite plugin for Codex: Skills and MCP in one install"
description: The Appwrite plugin for Codex bundles agent skills and the Appwrite Docs MCP server into a single install, so Codex can build with Appwrite out of the box.
date: 2026-05-11
cover: /images/blog/announcing-appwrite-codex-plugin/cover.png
timeToRead: 4
author: aditya-oberai
category: announcement
featured: false
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Probably should have FAQ, especially around why API MCP is not supported. We do cover it in the article, but FAQs should be good here in frontmatter

---

Codex is OpenAI's terminal-resident coding agent. It reads, writes, and runs code against your project, and it has been steadily picking up the building blocks needed to work well with platforms like Appwrite: skills for language-specific context, MCP servers for live tool and documentation access, and a marketplace for distributing them. Using Codex with Appwrite has worked for a while, but getting set up meant copying skill files into `~/.codex/skills/`, hand-editing `~/.codex/config.toml` to register the docs MCP, and stitching everything together yourself.

Today, we are announcing the **Appwrite plugin for Codex**. Add the marketplace, install the plugin, and your agent is ready to build with Appwrite using up-to-date SDK patterns and live access to the Appwrite documentation.

# What installing the plugin gives you

The plugin ships two things in a single install:

- **The Appwrite Docs MCP server:** No credentials required. Codex can search the Appwrite documentation as it works, instead of relying on whatever it was trained on.
- **Thirteen agent skills:** Markdown skills covering the Appwrite CLI and every major Appwrite SDK (TypeScript, Dart, .NET, Go, Kotlin, PHP, Python, Ruby, Rust, and Swift), plus two guided deployment skills for shipping Appwrite Sites and Functions with the Appwrite CLI. Codex loads the relevant skill on its own when a task calls for it, and the deployment skills can also be invoked explicitly with `$appwrite-deploy-site` and `$appwrite-deploy-function`.

# Setup the plugin
Comment thread
greptile-apps[bot] marked this conversation as resolved.

1. Add the Appwrite marketplace to Codex by running the following command in your terminal:

```bash
codex plugin marketplace add appwrite/codex-plugin
```

2. Start Codex by running `codex`.
3. Open the plugins menu with `/plugins`.
4. Select **Appwrite** from the marketplace listing and confirm the install.

The skills and the `appwrite-docs` MCP server are wired up automatically.

## Why the API MCP server isn't bundled

The Appwrite API MCP server needs three values to talk to your project: your endpoint, project ID, and API key. Codex plugins don't currently expose a way to prompt for and inject per-install configuration like that in the CLI, so shipping the API MCP inside the plugin would mean hard-coding credentials, which isn't something we want to do. The docs MCP, which doesn't need credentials, is bundled.

To add the API MCP server, run this in your terminal:

```bash
codex mcp add appwrite-api \
--env APPWRITE_PROJECT_ID=your-project-id \
--env APPWRITE_API_KEY=your-api-key \
--env APPWRITE_ENDPOINT=https://<REGION>.cloud.appwrite.io/v1 \
-- uvx mcp-server-appwrite
```

# A prompt to try first

Once the plugin is active, try a prompt like:

`Scaffold a Next.js app that uses Appwrite for email/password auth and a "todos" table.`

Codex picks up the `appwrite-typescript` and `appwrite-cli` skills, queries the Appwrite Docs MCP server when it needs to confirm specifics, and generates code that uses the right SDK calls instead of guessed ones. When you are ready to ship, ask it to deploy with the Appwrite CLI and the `$appwrite-deploy-site` skill walks it through the steps.

# Resources

- [Codex plugin docs](/docs/tooling/ai/ai-dev-tools/codex)
- [Plugin source code on GitHub](https://github.com/appwrite/codex-plugin)
- [Appwrite Skills](/docs/tooling/ai/skills)
- [Discord community](https://appwrite.io/discord)
12 changes: 12 additions & 0 deletions src/routes/changelog/(entries)/2026-05-11.markdoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
layout: changelog
title: "Appwrite plugin for Codex"
date: 2026-05-11
cover: /images/blog/announcing-appwrite-codex-plugin/cover.png
---

The Appwrite plugin is now available for Codex. Install it to get agent skills for the Appwrite CLI and every major SDK, two guided deployment skills for Sites and Functions, and the Appwrite Docs MCP server, all in a single setup.

{% arrow_link href="/blog/post/announcing-appwrite-codex-plugin" %}
Read the announcement
{% /arrow_link %}
38 changes: 34 additions & 4 deletions src/routes/docs/tooling/ai/ai-dev-tools/codex/+page.markdoc
Original file line number Diff line number Diff line change
@@ -1,10 +1,38 @@
---
layout: article
title: Codex
description: Learn how to use Codex with Appwrite through quick start prompts and MCP servers for AI-assisted development.
description: Learn how to use Codex with Appwrite through the Appwrite plugin, quick start prompts, and MCP servers for AI-assisted development.
---

{% section #quick-start-prompts step=1 title="Quick start prompts" %}
{% section #install-plugin step=1 title="Install the Appwrite plugin" %}

The fastest way to get started with Appwrite in Codex is to install the **Appwrite plugin** from the Appwrite marketplace. The plugin includes agent skills for the Appwrite CLI and all major SDKs and registers the Appwrite Docs MCP server, giving Codex everything it needs to work with your Appwrite projects.
Comment thread
adityaoberai marked this conversation as resolved.
Outdated

Add the Appwrite marketplace to Codex by running the following command in your terminal:

```bash
codex plugin marketplace add appwrite/codex-plugin
```

Then run `codex` and open the plugins menu to install the Appwrite plugin:

- Run `/plugins` in Codex.
- Select the **Appwrite** plugin from the marketplace listing.
- Confirm the install.

Once installed, the language and deployment skills load automatically based on your task, and the `appwrite-docs` MCP server is registered for documentation lookups.

The Appwrite API MCP server isn't bundled in the plugin: it needs your endpoint, project ID, and API key, and Codex plugins don't currently expose a way to prompt for per-install configuration in the CLI. Add it manually in [Step 3](#step-3).

{% info title="Prefer manual setup?" %}

If you'd rather copy skills and configure the MCP server yourself, skip to [Step 3](#step-3).

{% /info %}
Comment thread
adityaoberai marked this conversation as resolved.

{% /section %}

{% section #quick-start-prompts step=2 title="Quick start prompts" %}

Get started quickly with these pre-built prompts for common Appwrite integrations:

Expand All @@ -21,7 +49,9 @@ Browse all quick start prompts

{% /section %}

{% section #step-2 step=2 title="Add MCP servers" %}
{% section #step-3 step=3 title="Add MCP servers manually" %}

If you installed the Appwrite plugin in [Step 1](#install-plugin), the docs MCP server is already configured and you can skip to [Step 4](#step-4).

Connect Appwrite MCP servers to Codex for deeper integration with the Appwrite API and documentation.

Expand Down Expand Up @@ -73,7 +103,7 @@ codex mcp add appwrite-docs --url https://mcp-for-docs.appwrite.io

{% /section %}

{% section #step-3 step=3 title="Test the integration" %}
{% section #step-4 step=4 title="Test the integration" %}

Try out the following example prompts based on the MCP server you have configured:

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading