{
  "markdown": "# Appwrite MCP server\n\n[![MCP Registry Version](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fregistry.modelcontextprotocol.io%2Fv0.1%2Fservers%2Fio.github.appwrite%252Fmcp%2Fversions%2Flatest&query=%24.server.version&label=MCP%20Registry&logo=modelcontextprotocol)](https://registry.modelcontextprotocol.io/?q=io.github.appwrite%2Fmcp)\n\n<!-- mcp-name: io.github.appwrite/mcp -->\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server for Appwrite.\nIt exposes Appwrite's API — databases, users, functions, teams, storage, and more\n— as tools your MCP client can call.\n\nConnect to the hosted server at **`https://mcp.appwrite.io/`** and authenticate\nthrough your browser. The first time you connect, your client opens an Appwrite\nconsent screen; approve the scopes and you're connected. There are no keys to\ncopy. The conventional `https://mcp.appwrite.io/mcp` URL is also supported and\nconnects to the same server.\n\n![How the Appwrite MCP server handles OAuth and scopes](docs/appwrite-mcp-flow.png)\n\n## Connect your client\n\nPick your client below. Each adds the hosted Appwrite Cloud server.\n\n<details open>\n<summary><b>Claude Code</b></summary>\n\n```bash\nclaude mcp add --transport http appwrite https://mcp.appwrite.io/\n```\n\nThen, inside a Claude Code session, run `/mcp`, select **appwrite**, and follow\nthe browser prompt to authenticate.\n\n</details>\n\n<details>\n<summary><b>Claude Desktop</b></summary>\n\nGo to **Settings → Connectors → Add custom connector** and paste\n`https://mcp.appwrite.io/`. Available on Pro and Max plans; on Team and\nEnterprise plans only an organization Owner can add custom connectors.\n\nIf you don't see that option (free plan, or a Team/Enterprise member), bridge\nthe remote server through stdio instead (requires Node.js). Go to **Settings → Developer → Local MCP servers**, click\n**Edit Config**, and add:\n\n```json\n{\n  \"mcpServers\": {\n    \"appwrite\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.appwrite.io/\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop; the server appears under **Local MCP servers** and a\nbrowser window opens to authenticate.\n\n![Appwrite server running under Local MCP servers in Claude Desktop](docs/images/claude-desktop-local-mcp-servers.png)\n\n</details>\n\n<details>\n<summary><b>Cursor</b></summary>\n\nEdit `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project).\n\n```json\n{\n  \"mcpServers\": {\n    \"appwrite\": {\n      \"url\": \"https://mcp.appwrite.io/\"\n    }\n  }\n}\n```\n\nCursor prompts you to log in through the browser; the server then shows up\nunder **Settings → MCP** with its tools enabled.\n\n![Appwrite server connected in Cursor's MCP settings](docs/images/cursor-mcp.png)\n\n</details>\n\n<details>\n<summary><b>VS Code</b> (GitHub Copilot)</summary>\n\nEdit `.vscode/mcp.json` (workspace) or your user configuration via the Command\nPalette → **MCP: Open User Configuration**.\n\n```json\n{\n  \"servers\": {\n    \"appwrite\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.appwrite.io/\"\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Codex</b></summary>\n\nEdit `~/.codex/config.toml`.\n\n```toml\n[mcp_servers.appwrite]\nurl = \"https://mcp.appwrite.io/\"\n```\n\nThen authenticate from the terminal:\n\n```bash\ncodex mcp login appwrite\n```\n\nIn the Codex GUI, you can instead add the server from the MCP settings —\nset the URL to `https://mcp.appwrite.io/` and leave the token and header\nfields empty (authentication happens through the browser):\n\n![Appwrite MCP server settings in the Codex GUI](docs/images/codex-mcp.png)\n\n</details>\n\n<details>\n<summary><b>OpenCode</b></summary>\n\nEdit `opencode.json` (project) or `~/.config/opencode/opencode.json` (global).\n\n```json\n{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"mcp\": {\n    \"appwrite\": {\n      \"type\": \"remote\",\n      \"url\": \"https://mcp.appwrite.io/\",\n      \"enabled\": true\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Windsurf</b></summary>\n\nEdit `~/.codeium/windsurf/mcp_config.json`.\n\n```json\n{\n  \"mcpServers\": {\n    \"appwrite\": {\n      \"serverUrl\": \"https://mcp.appwrite.io/\"\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Gemini CLI</b></summary>\n\n```bash\ngemini mcp add --transport http appwrite https://mcp.appwrite.io/\n```\n\nOr edit `~/.gemini/settings.json` (note the key is `httpUrl`, not `url`):\n\n```json\n{\n  \"mcpServers\": {\n    \"appwrite\": {\n      \"httpUrl\": \"https://mcp.appwrite.io/\"\n    }\n  }\n}\n```\n\nGemini CLI opens the browser OAuth flow automatically on first connect. To\nre-authenticate, run `/mcp auth appwrite` inside a session.\n\n</details>\n\n<details>\n<summary><b>Antigravity (CLI & 2.0)</b></summary>\n\nEdit `~/.gemini/config/mcp_config.json` (global) or `.agents/mcp_config.json` (project workspace).\n\n```json\n{\n  \"mcpServers\": {\n    \"appwrite\": {\n      \"serverUrl\": \"https://mcp.appwrite.io/\"\n    }\n  }\n}\n```\n\n> ⚠️ **Note:** Antigravity strictly requires the `serverUrl` key for remote transport. Using legacy fields like `url` or `httpUrl` will cause tool registration to fail silently.\n\nAntigravity opens the browser OAuth flow automatically on first connect. If you manually edit the JSON file, navigate to **Settings → Customizations → Installed MCP Servers** and click **Refresh** to reload the tool definitions.\n\n</details>\n\n<details>\n<summary><b>GitHub Copilot CLI</b></summary>\n\n```bash\ncopilot mcp add --transport http appwrite https://mcp.appwrite.io/\n```\n\nOr run `/mcp add` inside a session, or edit `~/.copilot/mcp-config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"appwrite\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.appwrite.io/\"\n    }\n  }\n}\n```\n\nA browser window opens to authenticate on first connect. Check status with\n`/mcp`.\n\n</details>\n\n<details>\n<summary><b>Zed</b></summary>\n\nGo to **Settings → AI → MCP Servers → Add Server → Add Remote Server**, or add\nto your `settings.json` (`zed: open settings`):\n\n```json\n{\n  \"context_servers\": {\n    \"appwrite\": {\n      \"url\": \"https://mcp.appwrite.io/\"\n    }\n  }\n}\n```\n\nZed prompts you to authenticate through the browser on first connect.\n\n</details>\n\n<details>\n<summary><b>Warp</b></summary>\n\nGo to **Settings → Agents → MCP servers → + Add**, choose the URL-based\nserver type, and enter `https://mcp.appwrite.io/`.\n\nWarp opens a browser window to authenticate on first connect.\n\n</details>\n\n<details>\n<summary><b>JetBrains AI Assistant / Junie</b></summary>\n\nJetBrains IDEs don't yet support OAuth for remote MCP servers, so bridge\nthrough stdio (requires Node.js). Go to **Settings → Tools → AI Assistant →\nModel Context Protocol (MCP) → Add**, switch to the JSON view, and paste:\n\n```json\n{\n  \"mcpServers\": {\n    \"appwrite\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.appwrite.io/\"]\n    }\n  }\n}\n```\n\nA browser window opens to authenticate on first connect.\n\n</details>\n\n<details>\n<summary><b>Cline</b></summary>\n\nCline doesn't yet support OAuth for remote MCP servers, so bridge through\nstdio (requires Node.js). In the Cline panel, open the **MCP Servers** icon →\n**Configure** tab → **Configure MCP Servers**, and add:\n\n```json\n{\n  \"mcpServers\": {\n    \"appwrite\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.appwrite.io/\"]\n    }\n  }\n}\n```\n\nA browser window opens to authenticate on first connect.\n\n</details>\n\n## Self-hosted Appwrite\n\nRunning your own Appwrite instance? Run the MCP server locally over `stdio` and\nauthenticate with a project API key. See [docs/self-hosted.md](docs/self-hosted.md)\nfor per-client setup.\n\n## Documentation\n\n- [Tool surface](docs/tool-surface.md) — the tools exposed to the model and the\n  internal Appwrite catalog.\n- [How Cloud authentication works](docs/authentication.md) — the OAuth 2.1 flow.\n- [Documentation search](docs/documentation-search.md) — the in-process\n  `appwrite_search_docs` tool and how to rebuild its index.\n- [Self-hosted Appwrite](docs/self-hosted.md) — run the server locally with a\n  project API key.\n- [Local development](docs/development.md) — running, testing, and debugging the\n  server locally.\n- [AGENTS.md](AGENTS.md) — full contributor guide and pre-PR checklist.\n\n## License\n\nThis MCP server is licensed under the MIT License. See the [LICENSE](LICENSE) file\nfor details.\n",
  "bytes": 8169,
  "sha": "29131b4c069b16d1d6677b50110cee3e4cb2dfe5c58092fb0df532897147c49a",
  "repo_slug": "appwrite/mcp-for-api",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_appwrite_mcp_for_api_290c3680/readme"
}