Install

Set up AgentGraph locally, connect the extension, and hand off to Quickstart for authentication and first indexing.

The install flow below uses the default SQLite backend.

#Prerequisites

AgentGraph expects Python 3.12 or later and uv.

curl -LsSf https://astral.sh/uv/install.sh | sh

#Sync dependencies

Clone the repository and install the first-party connectors you need.

git clone https://github.com/simonexmachina/agent-graph
cd agent-graph
uv sync --extra all

You can also sync only the connectors you want:

uv sync --extra google
uv sync --extra slack
uv sync --extra discord
uv sync --extra rss

Credential storage: credentials live in ~/.agentgraph/ by default, or under AGENTGRAPH_CONFIG_DIR if you set a custom config directory.

#Run the server

agentgraph serve accepts browser dwell events, runs connector pollers, serves the viewer, and exposes the local HTTP backend.

agentgraph serve

Logs are written to standard output.

#Install the browser extension

Install the AgentGraph Chrome Extension from the Chrome Web Store.

If you want to build the extension yourself instead, use:

cd extension
npm install
npm run build

Then open chrome://extensions, enable Developer Mode, click Load unpacked, and select extension/dist/.

After the extension is installed, continue with Quickstart to authenticate connectors, start the server, and verify that your first entities land in the graph.

#Connect MCP clients

Print the client config:

agentgraph mcp-config

See mcp-config for the command details and transport examples.

For ChatGPT, enable Developer mode and point a remote MCP connector at an AgentGraph SSE or streaming HTTP endpoint.

#Run in the background

Only agentgraph serve needs to be long-running. MCP stdio mode is spawned on demand by the client.

#macOS launchd

which agentgraph

cat > ~/Library/LaunchAgents/com.agentgraph.serve.plist <<'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.agentgraph.serve</string>
  <key>ProgramArguments</key>
  <array>
    <string>/Users/you/.local/bin/agentgraph</string>
    <string>serve</string>
  </array>
  <key>RunAtLoad</key>
  <true/>
  <key>KeepAlive</key>
  <true/>
  <key>StandardOutPath</key>
  <string>/tmp/com.agentgraph.serve.log</string>
  <key>StandardErrorPath</key>
  <string>/tmp/com.agentgraph.serve.log</string>
</dict>
</plist>
EOF

launchctl load ~/Library/LaunchAgents/com.agentgraph.serve.plist

#Linux systemd

which agentgraph

mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/agentgraph.service <<'EOF'
[Unit]
Description=AgentGraph local knowledge graph server
After=network.target

[Service]
ExecStart=/home/you/.local/bin/agentgraph serve
Restart=on-failure
RestartSec=5
StandardOutput=append:/tmp/agentgraph-serve.log
StandardError=append:/tmp/agentgraph-serve.log

[Install]
WantedBy=default.target
EOF

systemctl --user daemon-reload
systemctl --user enable --now agentgraph