Apollo MCP Server
MCP server that exposes GraphQL operations as tools for AI models.
Apollo MCP Server
Apollo MCP Server is a Model Context Protocol server that exposes GraphQL operations as MCP tools. It provides a standard way for AI models to access and orchestrate your APIs running with Apollo.
Documentation
See the documentation for full details. This README shows the basics of getting this MCP server running. More details are available on the documentation site.
Installation
You can either build this server from source, if you have Rust installed on your workstation, or you can follow the installation guide. To build from source, run cargo build from the root of this repository and the server will be built in the target/debug directory.
Getting started
Follow the quickstart tutorial to get started with this server.
Usage
Full usage of Apollo MCP Server is documented on the user guide. There are a few items that are necessary for this server to function. Specifically, the following things must be configured:
- A graph for the MCP server to sit in front of.
- Definitions for the GraphQL operations that should be exposed as MCP tools.
- A configuration file describing how the MCP server should run.
- A connection to an MCP client, such as an LLM or MCP inspector.
These are all described on the user guide. Specific configuration options for the configuration file are documented in the config file reference.
Contributions
Checkout the contributor guidelines for more information.
Licensing
This project is licensed under the MIT License. See the LICENSE file for the full license text.
Security
Refer to our security policy.
[!IMPORTANT]
Do not open up a GitHub issue if a found bug is a security vulnerability, and instead to refer to our security policy.
Installation
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
docker run -i --rm ghcr.io/apollographql/apollo-mcp-server:v1.20.0Set up in your AI client
Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-apollographql-apollo-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/apollographql/apollo-mcp-server:v1.20.0"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referencePackage
ghcr.io/apollographql/apollo-mcp-server:v1.20.0dockerCompatible MCP Clients
Apollo MCP Server works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
- Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect. - Cursor
~/.cursor/mcp.jsonRestart Cursor for changes to take effect. - VS Code
.vscode/mcp.jsonReload VS Code window for changes to take effect. - Windsurf
~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect. - Claude Code
.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.