Skip to content

Tooling

Claude Code_

Learn how to use Claude Code with Appwrite through the Appwrite plugin, quick start prompts, and the Appwrite MCP server for AI-assisted development.

2 min read

Raw

1. Install the Appwrite plugin

The fastest way to get started with Appwrite in Claude Code is to install the Appwrite plugin from the official marketplace. The plugin includes the hosted Appwrite MCP server, agent skills for the CLI and all major SDKs, and commands for deploying sites and functions.

To install the plugin, run the following command in your terminal:

Bash
claude plugin install appwrite@claude-plugins-official

If Claude Code cannot find the plugin, add the Appwrite marketplace and install it from there:

Bash
claude plugin marketplace add appwrite/claude-plugin
claude plugin install appwrite@appwrite

Run /reload-plugins in Claude Code to load the plugin in your current session. Then run /mcp, select the Appwrite server, and choose Authenticate. Your browser opens so you can sign in to your Appwrite account and authorize access. The plugin does not need an API key.

If you installed an earlier version that asked for an endpoint, project ID, and API key, run /plugins, open the Installed tab, and update the Appwrite plugin.

2. Quick start prompts

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

TanStack Start

Next.js

3. Manual setup without the plugin (optional)

Skip this step if you installed the plugin, since it already includes the MCP server. Adding the server again registers it twice. To connect the Appwrite MCP server directly, add the remote HTTP server below. There are no additional prerequisites to install.

Run the following command in your terminal to add the MCP server:

Bash
claude mcp add --transport http appwrite https://mcp.appwrite.io/

The server uses OAuth for authentication. Run /mcp in Claude Code, select appwrite, and choose Authenticate. Your browser opens so you can sign in to your Appwrite account and authorize access.

If you run Claude Code on a remote host, log in from the shell with --no-browser:

Bash
claude mcp login appwrite --no-browser

Open the printed authorization URL in a browser on your local machine, sign in, and authorize access. After you approve, copy the full http://localhost:.../callback URL from the address bar and paste it into the Claude Code prompt. Use an interactive SSH session (ssh -t) so the prompt can accept the paste. This is the same localhost-callback pattern described in Authenticate from a remote machine.

4. Verify MCP tools

Run the following command in your terminal (where Claude Code is running).

Bash
/mcp

You should see the added MCP server listed there.

Verify MCP tools
Verify MCP tools

5. Test the integration

Try out the following example prompts:

Example prompts:

  • Create a new user in my Appwrite project
  • List all databases in my project
  • Show me the tables in my database
  • How do I set up real-time subscriptions in Appwrite?
  • Show me how to authenticate users with OAuth
  • How do I implement file uploads with Appwrite Storage?

Implement file uploads
Implement file uploads

Was this page helpful?

Share what worked or what we should fix. Once approved, our agents automatically apply suggested updates to the docs.