## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.SIGN UP
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.LOG IN
Connect CrewAI to Gist MCP. List all your public and private gists, show comments for gist with id abc123, and more using natural language, with authentication handled for you.
GistGitHub Gist is a service for sharing code snippets and notes. It makes it easy to collaborate and organize your code or text, publicly or privately.
This guide walks you through connecting Gist to CrewAI using the Composio tool router. By the end, you'll have a working Gist agent that can create and update gists, fork and star snippets, comment on gists, and browse revision history through natural language commands.
This guide will help you understand how to give your CrewAI agent real control over a Gist account through Composio's Gist MCP server.
Before we dive in, let's take a quick look at the key ideas and tools involved.
CrewAI is a powerful framework for building multi-agent AI systems. It provides primitives for defining agents with specific roles, creating tasks, and orchestrating workflows through crews.
Key features include:
The Gist MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your GitHub Gist account. It provides structured and secure access to your gists, so your agent can create, manage, comment on, and organize code snippets and notes on your behalf.
Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK
The tool router generates a secure MCP URL that your agents can access to perform actions.
The Composio SDK follows a three-phase workflow:
pip install composio crewai crewai-tools[mcp] python-dotenvcomposio connects your agent to Gist via MCPcrewai provides Agent, Task, Crew, and LLM primitivescrewai-tools[mcp] includes MCP helperspython-dotenv loads environment variables from .envCOMPOSIO_API_KEY=your_composio_api_key_here
USER_ID=your_user_id_here
OPENAI_API_KEY=your_openai_api_key_hereCreate a .env file in your project root.
What's happening:
COMPOSIO_API_KEY authenticates with ComposioUSER_ID scopes the session to your accountOPENAI_API_KEY lets CrewAI use your chosen OpenAI modelimport os
from composio import Composio
from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
import dotenv
dotenv.load_dotenv()
COMPOSIO_API_KEY = os.getenv("COMPOSIO_API_KEY")
COMPOSIO_USER_ID = os.getenv("COMPOSIO_USER_ID")
if not COMPOSIO_API_KEY:
raise ValueError("COMPOSIO_API_KEY is not set")
if not COMPOSIO_USER_ID:
raise ValueError("COMPOSIO_USER_ID is not set")MCPServerHTTP connects the agent to an MCP endpointComposio will give you a short lived Gist MCP URLcomposio_client = Composio(api_key=COMPOSIO_API_KEY)
session = composio_client.create(user_id=COMPOSIO_USER_ID, toolkits=["gist"])
url = session.mcp.urlserver_params = {
"url": url,
"transport": "streamable-http",
"headers": {"x-api-key": COMPOSIO_API_KEY},
}
with MCPServerAdapter(server_params) as tools:
agent = Agent(
role="Search Assistant",
goal="Help users search the internet effectively",
backstory="You are a helpful assistant with access to search tools.",
tools=tools,
verbose=False,
max_iter=10,
)MCPServerAdapter acts as a context manager that converts Composio MCP tools into a CrewAI-compatible format.print("Chat started! Type 'exit' or 'quit' to end.\n")
conversation_context = ""
while True:
user_input = input("You: ").strip()
if user_input.lower() in ["exit", "quit", "bye"]:
print("\nGoodbye!")
break
if not user_input:
continue
conversation_context += f"\nUser: {user_input}\n"
print("\nAgent is thinking...\n")
task = Task(
description=(
f"Conversation history:\n{conversation_context}\n\n"
f"Current request: {user_input}"
),
expected_output="A helpful response addressing the user's request",
agent=agent,
)
crew = Crew(agents=[agent], tasks=[task], verbose=False)
result = crew.kickoff()
response = str(result)
conversation_context += f"Agent: {response}\n"
print(f"Agent: {response}\n")Here's the complete code to get you started with Gist and CrewAI:
from crewai import Agent, Task, Crew, LLM
from crewai_tools import MCPServerAdapter
from composio import Composio
from dotenv import load_dotenv
import os
load_dotenv()
GOOGLE_API_KEY = os.getenv("GOOGLE_API_KEY")
COMPOSIO_API_KEY = os.getenv("COMPOSIO_API_KEY")
COMPOSIO_USER_ID = os.getenv("COMPOSIO_USER_ID")
if not GOOGLE_API_KEY:
raise ValueError("GOOGLE_API_KEY is not set in the environment.")
if not COMPOSIO_API_KEY:
raise ValueError("COMPOSIO_API_KEY is not set in the environment.")
if not COMPOSIO_USER_ID:
raise ValueError("COMPOSIO_USER_ID is not set in the environment.")
# Initialize Composio and create a session
composio = Composio(api_key=COMPOSIO_API_KEY)
session = composio.create(
user_id=COMPOSIO_USER_ID,
toolkits=["gist"],
)
url = session.mcp.url
# Configure LLM
llm = LLM(
model="gpt-5",
api_key=os.getenv("OPENAI_API_KEY"),
)
server_params = {
"url": url,
"transport": "streamable-http",
"headers": {"x-api-key": COMPOSIO_API_KEY},
}
with MCPServerAdapter(server_params) as tools:
agent = Agent(
role="Search Assistant",
goal="Help users with internet searches",
backstory="You are an expert assistant with access to Composio Search tools.",
tools=tools,
llm=llm,
verbose=False,
max_iter=10,
)
print("Chat started! Type 'exit' or 'quit' to end.\n")
conversation_context = ""
while True:
user_input = input("You: ").strip()
if user_input.lower() in ["exit", "quit", "bye"]:
print("\nGoodbye!")
break
if not user_input:
continue
conversation_context += f"\nUser: {user_input}\n"
print("\nAgent is thinking...\n")
task = Task(
description=(
f"Conversation history:\n{conversation_context}\n\n"
f"Current request: {user_input}"
),
expected_output="A helpful response addressing the user's request",
agent=agent,
)
crew = Crew(agents=[agent], tasks=[task], verbose=False)
result = crew.kickoff()
response = str(result)
conversation_context += f"Agent: {response}\n"
print(f"Agent: {response}\n")You now have a CrewAI agent connected to Gist through Composio's Tool Router. The agent can perform Gist operations through natural language commands.
Next steps:
Every Gist action and event your agent gets out of the box.
Use Gist MCP with Claude Code
Use Gist MCP with Claude Cowork
Use Gist MCP with OpenAI Agents SDK
Use Gist MCP with Claude Agent SDK
Use Gist MCP with Grok Bot
Use Gist MCP with Codex
Use Gist MCP with OpenClaw
Use Gist MCP with Hermes
Use Gist MCP with Atomic Agent
Use Gist MCP with Google ADK
Use Gist MCP with LangChain
Use Gist MCP with Vercel AI SDK
Use Gist MCP with Mastra AI
Use Gist MCP with LlamaIndex
Use Gist MCP with Pydantic AI
Use Gist MCP with AutoGen
Supabase is an open-source backend platform offering scalable Postgres databases, authentication, storage, and real-time APIs. It lets developers build modern apps without managing infrastructure.
Codeinterpreter is a Python-based coding environment with built-in data analysis and visualization. It lets you instantly run scripts, plot results, and prototype solutions inside supported platforms.
GitHub is a code hosting platform for version control and collaborative software development. It streamlines project management, code review, and team workflows in one place.
1Password is a password manager and digital vault for storing logins, secrets, notes, and secure documents. It helps individuals and teams protect credentials, share access safely, and reduce password risk.
Managed auth, hosted MCP servers, and every Gist tool your agent needs.Free to start.
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.Start building