ADK Go
An open-source, code-first Go toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control.
What is ADK Go?
ADK Go is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to open-source, code-first go toolkit for building, evaluating, and deploying sophisticated ai agents with flexibility and control.
An open-source, code-first Go toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control.
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- An open-source, code-first Go toolkit for building, evaluati
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx adk-goConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use ADK Go
ADK Go is Google's open-source, code-first Go toolkit for building, evaluating, and deploying sophisticated AI agents, optimized for Gemini models but compatible with any LLM provider. It brings idiomatic Go patterns — goroutines, interfaces, and strong typing — to AI agent development, supporting multi-agent composition, a rich tool ecosystem, and cloud-native deployment to platforms like Google Cloud Run. Developers use it to build production-grade agents with the reliability and concurrency strengths of the Go language.
Prerequisites
- Go 1.21+ installed (run 'go version' to verify)
- A Google AI Studio or Vertex AI API key for Gemini model access (GEMINI_API_KEY or Google Cloud credentials)
- Google Cloud SDK installed if deploying to Cloud Run
- An MCP-compatible client if using ADK Go's MCP server capabilities
- Git to clone the repository and access examples
Add ADK Go to your Go module
Initialize a new Go module or add the ADK Go package to your existing project using go get.
go mod init my-agent
go get google.golang.org/adkSet up your LLM credentials
Export your Gemini API key or configure Application Default Credentials for Vertex AI.
# For Google AI Studio (Gemini API)
export GEMINI_API_KEY=your-gemini-api-key
# For Vertex AI (Google Cloud)
gcloud auth application-default login
export GOOGLE_CLOUD_PROJECT=your-project-idClone the ADK Go examples to get started
Review the examples directory to understand agent patterns before building your own.
git clone https://github.com/google/adk-go.git
cd adk-go/examplesBuild and run a sample agent
Run one of the provided examples to verify your environment is configured correctly.
cd examples/hello_world
go run main.goBuild your own agent with custom tools
Create an agent with the ADK Go framework by defining tools as Go functions and registering them with the agent.
package main
import (
"google.golang.org/adk/agents"
"google.golang.org/adk/tools"
)
func main() {
agent := agents.New(
agents.WithModel("gemini-2.0-flash"),
agents.WithTools(myCustomTool),
)
agent.Run()
}ADK Go Examples
Client configuration
MCP client config block for an ADK Go MCP server built with the toolkit, running as a local binary.
{
"mcpServers": {
"adk-go-agent": {
"command": "/path/to/your/adk-go-agent",
"args": ["--stdio"],
"env": {
"GEMINI_API_KEY": "your-gemini-api-key",
"GOOGLE_CLOUD_PROJECT": "your-project-id"
}
}
}
}Prompts to try
Example prompts for working with AI agents built using the ADK Go framework.
- "Build a Go agent using ADK that can search the web and summarize results."
- "Show me how to compose two ADK Go agents where one delegates tasks to the other."
- "Create a multi-step workflow agent in Go that fetches weather data and creates a travel plan."
- "How do I add a custom tool to an ADK Go agent that queries a PostgreSQL database?"
- "Deploy my ADK Go agent to Google Cloud Run — what configuration do I need?"Troubleshooting ADK Go
go get fails with 'module not found' for google.golang.org/adk
Ensure your Go version is 1.21 or higher ('go version'). Also confirm your GOPATH and module proxy settings are correct. Try setting GOFLAGS=-mod=mod and re-running 'go get google.golang.org/adk@latest'.
PERMISSION_DENIED or authentication errors when calling Gemini
Verify GEMINI_API_KEY is exported in the same shell session running the agent. For Vertex AI, run 'gcloud auth application-default login' and confirm GOOGLE_CLOUD_PROJECT is set to a project with the Vertex AI API enabled.
Agent compiles but produces no output or crashes immediately
Check the examples directory for working reference implementations. Enable verbose logging by setting LOG_LEVEL=debug in your environment. Ensure the model name string matches a valid Gemini model identifier (e.g. 'gemini-2.0-flash' not 'gemini-flash').
Frequently Asked Questions about ADK Go
What is ADK Go?
ADK Go is a Model Context Protocol (MCP) server that open-source, code-first go toolkit for building, evaluating, and deploying sophisticated ai agents with flexibility and control. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install ADK Go?
Follow the installation instructions on the ADK Go GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with ADK Go?
ADK Go works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is ADK Go free to use?
Yes, ADK Go is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
ADK Go Alternatives — Similar Coding Agents Servers
Looking for alternatives to ADK Go? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up ADK Go in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use ADK Go?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.