home / mcp / appwrite mcp server

Appwrite MCP Server

Appwrite’s MCP server. Operating your backend has never been easier.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "appwrite-mcp-for-api": {
      "command": "uvx",
      "args": [
        "mcp-server-appwrite"
      ],
      "env": {
        "APPWRITE_API_KEY": "<YOUR_API_KEY>",
        "APPWRITE_ENDPOINT": "https://<REGION>.cloud.appwrite.io/v1",
        "APPWRITE_PROJECT_ID": "<YOUR_PROJECT_ID>"
      }
    }
  }
}

You can run the Appwrite MCP server locally to expose Appwrite APIs as MCP tools that your client can invoke. This server lets you manage databases, users, functions, teams, and more within your Appwrite project through standardized MCP endpoints.

How to use

You will run a local MCP server process that exposes Appwrite API tools to your MCP client. Start the server with your preferred method, then enable the specific tools you need for your workflow. Your MCP client will communicate with the local server to perform actions like managing databases, users, and other Appwrite resources.

How to install

Prerequisites: you need either the uvx runtime or Python with pip to install and run the MCP server. You should also have an Appwrite project ready with an API key and endpoint configured.

# Option 1: Using uvx (recommended)
uvx mcp-server-appwrite [args]

# Option 2: Using pip
pip install mcp-server-appwrite
# Then start the server
python -m mcp_server_appwrite [args]

Command-line arguments you can use

You can enable specific Appwrite APIs to balance token usage and context window size. By default, only the Databases tools are enabled. Use the following flags to enable additional APIs.

--tablesdb    Enables the TablesDB API
--users       Enables the Users API
--teams       Enables the Teams API
--storage     Enables the Storage API
--functions   Enables the Functions API
--messaging   Enables the Messaging API
--locale      Enables the Locale API
--avatars     Enables the Avatars API
--sites       Enables the Sites API
--all         Enables all Appwrite APIs
--databases   Enables the Legacy Databases API

Environment setup for Appwrite access

Create a .env file in your working directory and configure your Appwrite project values so the MCP server can connect to your Appwrite instance.

APPWRITE_PROJECT_ID=your-project-id
APPWRITE_API_KEY=your-api-key
APPWRITE_ENDPOINT=https://<REGION>.cloud.appwrite.io/v1

Available tools

databases

Access and manage Appwrite databases, including collections, documents, and database-related operations.

users

Manage project users, their roles, and permissions within Appwrite.

teams

Handle team creation, membership, and role assignments in your Appwrite project.

storage

Interact with Appwrite storage to upload, retrieve, and manage files.

functions

Create, update, and invoke Appwrite cloud functions.

messaging

Utilize Appwrite’s messaging capabilities for real-time or asynchronous communication.

locale

Access locale-related resources and internationalization features.

avatars

Generate or manage user avatars within Appwrite.

sites

Interact with Appwrite Sites API for site-related operations.

databases_legacy

Enable and work with the legacy Databases API.