Appwrite Codex Plugin

Appwrite tools for Codex. This plugin packages Appwrite SDK skills, Appwrite deployment workflow skills, and the hosted Appwrite MCP server.

Installation

From the OpenAI Curated marketplace

1. Run codex, then run /plugins.
2. Switch to the OpenAI Curated marketplace.
3. Search for Appwrite and install the plugin.
4. Sign in to Appwrite and approve access when prompted, then start a new Codex session.

The plugin can also be installed from Plugins in the ChatGPT desktop app.

From this repository

Add this repository as a marketplace and install the plugin from it:

codex plugin marketplace add appwrite/codex-plugin
codex plugin add appwrite@appwrite

Start a new Codex session to load the bundled skills.

Manual setup

To use the skills and the MCP server without the plugin, copy the skills into your user skills folder and register the server.

macOS / Linux:

mkdir -p ~/.agents/skills
cp -R plugins/appwrite/skills/* ~/.agents/skills/
codex mcp add appwrite --url https://mcp.appwrite.io/

Windows (PowerShell):

New-Item -ItemType Directory -Force -Path "$HOME\.agents\skills" | Out-Null
Copy-Item -Recurse plugins\appwrite\skills\* "$HOME\.agents\skills\"
codex mcp add appwrite --url https://mcp.appwrite.io/

Instead of codex mcp add, you can merge plugins/appwrite/config.toml into ~/.codex/config.toml.

Included skills

The plugin ships these skills under plugins/appwrite/skills/:

• appwrite-typescript
• appwrite-dart
• appwrite-kotlin
• appwrite-swift
• appwrite-php
• appwrite-python
• appwrite-ruby
• appwrite-go
• appwrite-rust
• appwrite-dotnet
• appwrite-cli
• deploy-site
• deploy-function

The language skills give Codex language-specific Appwrite context for authentication, database queries, storage, realtime, functions, and server-side administration. The deploy-site and deploy-function skills walk through deploying Appwrite Sites and Functions with the Appwrite CLI.

Codex loads a skill when a task matches its description. To invoke one explicitly, type $ or run /skills and pick it.

Hosted MCP server

The plugin registers one appwrite server at https://mcp.appwrite.io/. It provides tools for working with your Appwrite organizations and projects, and for searching the latest Appwrite documentation.

The hosted server uses browser-based OAuth, so no API key, project ID, endpoint, or other manually configured secret is required. Codex asks you to sign in when you install the plugin. To sign in again, or after a manual setup, run:

codex mcp login appwrite

Then try:

Use Appwrite to show my workspace context and list my projects.

If the browser does not open, use the authorization URL printed by Codex. Run codex mcp logout appwrite followed by codex mcp login appwrite to refresh the OAuth session, and codex mcp list to check that the server is configured.

Structure

.agents/plugins/marketplace.json            # Marketplace manifest
plugins/appwrite/
├── .codex-plugin/plugin.json             # Plugin manifest
├── .mcp.json                             # MCP server config for plugin installs
├── config.toml                           # MCP server config for manual setup
└── skills/
    ├── appwrite-typescript/SKILL.md
    ├── appwrite-dart/SKILL.md
    ├── appwrite-kotlin/SKILL.md
    ├── appwrite-swift/SKILL.md
    ├── appwrite-php/SKILL.md
    ├── appwrite-python/SKILL.md
    ├── appwrite-ruby/SKILL.md
    ├── appwrite-go/SKILL.md
    ├── appwrite-rust/SKILL.md
    ├── appwrite-dotnet/SKILL.md
    ├── appwrite-cli/SKILL.md
    ├── appwrite-deploy-site/SKILL.md
    └── appwrite-deploy-function/SKILL.md

Learn more

• Appwrite in Codex
• Appwrite MCP server
• Codex plugins documentation

Contribution

This library is auto-generated by Appwrite custom SDK Generator. To learn more about how you can help us improve this SDK, please check the contribution guide before sending a pull-request.

License

Please see the BSD-3-Clause license file for more information.