
Mcp For Api
io.github.appwritePublished by GitHub account appwritev0.2.8Updated Oct 24, 2026
MCP (Model Context Protocol) server for Appwrite
Overview
Exposes Appwrite's backend API — databases, users, functions, teams and storage — as tools an assistant can call, via a hosted OAuth server or a local stdio…
- What you can do
- Work with Appwrite databases, users, functions, teams and storage through the platform API
- List projects and their environments, and pass project and environment IDs on each call
- Search Appwrite documentation from an in-process docs tool
- Record a short reason with every write so changes appear in the project's audit log
- Connect either to the hosted Appwrite Cloud server or, for self-hosted instances, run locally over stdio with a project API key
- When to use it
- Useful when you build or operate an Appwrite project and want an assistant to inspect or change its data, users, functions, teams or files from inside your MCP client, on Appwrite Cloud or a self-hosted instance.
- Requirements
- An Appwrite project and account. The hosted server is reached over HTTP and authenticated through a browser OAuth consent screen with scopes you approve; no keys to copy. Clients without OAuth support need Node.js to bridge via npx mcp-remote. Self-hosted instances run the server locally over stdio with a project API key.
Installation
In SourceWeft
- Open Mcp For Api in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
Appwrite MCP server
A Model Context Protocol server for Appwrite. It exposes Appwrite's API — databases, users, functions, teams, storage, and more — as tools your MCP client can call.
Connect to the hosted server at https://mcp.appwrite.io/ and authenticate
through your browser. The first time you connect, your client opens an Appwrite
consent screen; approve the scopes and you're connected. There are no keys to
copy. The conventional https://mcp.appwrite.io/mcp URL is also supported and
connects to the same server.
[How the Appwrite MCP server handles OAuth and scopes]
Connect your client
Pick your client below. Each adds the hosted Appwrite Cloud server.
Claude Code
Then, inside a Claude Code session, run /mcp, select appwrite, and follow
the browser prompt to authenticate.
Claude Desktop
Go to Settings → Connectors → Add custom connector and paste
https://mcp.appwrite.io/. Available on Pro and Max plans; on Team and
Enterprise plans only an organization Owner can add custom connectors.
If you don't see that option (free plan, or a Team/Enterprise member), bridge the remote server through stdio instead (requires Node.js). Go to Settings → Developer → Local MCP servers, click Edit Config, and add:
Restart Claude Desktop; the server appears under Local MCP servers and a browser window opens to authenticate.
[Appwrite server running under Local MCP servers in Claude Desktop]
Cursor
Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Cursor prompts you to log in through the browser; the server then shows up under Settings → MCP with its tools enabled.
VS Code (GitHub Copilot)
Edit .vscode/mcp.json (workspace) or your user configuration via the Command
Palette → MCP: Open User Configuration.
Codex
Edit ~/.codex/config.toml.
Then authenticate from the terminal:
In the Codex GUI, you can instead add the server from the MCP settings —
set the URL to https://mcp.appwrite.io/ and leave the token and header
fields empty (authentication happens through the browser):
OpenCode
Edit opencode.json (project) or ~/.config/opencode/opencode.json (global).
Windsurf
Edit ~/.codeium/windsurf/mcp_config.json.
Gemini CLI
Or edit ~/.gemini/settings.json (note the key is httpUrl, not url):
Gemini CLI opens the browser OAuth flow automatically on first connect. To
re-authenticate, run /mcp auth appwrite inside a session.
Antigravity (CLI & 2.0)
Edit ~/.gemini/config/mcp_config.json (global) or .agents/mcp_config.json (project workspace).
⚠️ Note: Antigravity strictly requires the
serverUrlkey for remote transport. Using legacy fields likeurlorhttpUrlwill cause tool registration to fail silently.
Antigravity 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.
GitHub Copilot CLI
Or run /mcp add inside a session, or edit ~/.copilot/mcp-config.json:
A browser window opens to authenticate on first connect. Check status with
/mcp.
Zed
Go to Settings → AI → MCP Servers → Add Server → Add Remote Server, or add
to your settings.json (zed: open settings):
Zed prompts you to authenticate through the browser on first connect.
Warp
Go to Settings → Agents → MCP servers → + Add, choose the URL-based
server type, and enter https://mcp.appwrite.io/.
Warp opens a browser window to authenticate on first connect.
JetBrains AI Assistant / Junie
JetBrains IDEs don't yet support OAuth for remote MCP servers, so bridge through stdio (requires Node.js). Go to Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add, switch to the JSON view, and paste:
A browser window opens to authenticate on first connect.
Cline
Cline doesn't yet support OAuth for remote MCP servers, so bridge through stdio (requires Node.js). In the Cline panel, open the MCP Servers icon → Configure tab → Configure MCP Servers, and add:
A browser window opens to authenticate on first connect.
Reasons and environments
Every write the agent makes carries a short reason (why it made the change).
Appwrite records it on the project's audit log, so you can review what your
agent changed, and why, in the project's Activity tab.
On Appwrite Cloud, the agent can act in a project's environments (for example
staging): appwrite_get_context lists them, and each call takes the
environment's ID as environment_id next to the project's project_id. See
Tool surface.
Self-hosted Appwrite
Running your own Appwrite instance? Run the MCP server locally over stdio and
authenticate with a project API key. See docs/self-hosted.md
for per-client setup.
Documentation
- Tool surface — the tools exposed to the model and the internal Appwrite catalog.
- How Cloud authentication works — the OAuth 2.1 flow.
- Documentation search — the in-process
appwrite_search_docstool and how to rebuild its index. - Events — MCP Events: webhook subscriptions to changes in your Appwrite project (in development, not available yet).
- Self-hosted Appwrite — run the server locally with a project API key.
- Local development — running, testing, and debugging the server locally.
- AGENTS.md — full contributor guide and pre-PR checklist.
License
This MCP server is licensed under the MIT License. See the LICENSE file for details.
Source: README.md at commit 57d61ab
Tools
0Version history
1- v0.2.8LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts