Graphify for Codex

Pick the tab that matches how you run Graphify: Graphify (hosted) connects to the graph we build for you, Graphify Local reads a graph you build on your machine. Compare them.

Graphify (hosted)
Graphify Local

Connect Codex to Graphify’s hosted MCP server at https://api.graphify.com/mcp. Codex can then search the repositories indexed in your Graphify workspace, follow callers and dependencies, and check what a change reaches, without re-reading every file.The server uses Streamable HTTP and OAuth. You sign in once in the browser, so there is no API key to paste and no local process to run.

Before you start

A Graphify account at app.graphify.com. New accounts start on a 14-day Pro trial, then move to Free (up to 3 indexed repositories). No card is required.
At least one repository with the status Indexed. The quickstart connects GitHub and starts indexing. Indexing status is on Repositories and builds.

1. Add the server

Terminal

codex mcp add graphify --url https://api.graphify.com/mcp
codex mcp login graphify

The second command opens the browser sign-in. Without it the connection is unauthenticated and Graphify rejects it.config.tomlAdd this to ~/.codex/config.toml for your user, or to .codex/config.toml for one project:

~/.codex/config.toml

[mcp_servers.graphify]
url = "https://api.graphify.com/mcp"
auth = "oauth"

Then run codex mcp login graphify to sign in.Graphify pluginOpen the Graphify listing and select Install plugin, or open /plugins in Codex CLI and search for Graphify. Connect your Graphify account and finish the browser sign-in. The same plugin works in ChatGPT; see ChatGPT, Codex, and Dots.Use one path. Two connections show every Graphify tool twice.

2. Check the connection

Open a new Codex session and run /mcp to check that graphify is available. Then paste:

Use Graphify's list_repositories tool and show the repositories I can access. If the tool fails, report the error instead of guessing.

This is the same test prompt the console shows on Connectors → MCP → Try a query. Check that the list matches the workspace you chose when you signed in.

Optional: set a default repository

Add ?repo=owner/name to the endpoint, for example https://api.graphify.com/mcp?repo=Graphify-Labs/graphify. Graphify uses that repository when a tool call names none. A repository named in the call still wins.

3. Ask a question

Pick a repository from the list and name the symbol, file, or area you care about:

Who calls the function that validates a session token?
What would break if I changed this module's public interface?
Summarize how requests reach the billing service.

Answers are graph evidence from the files Graphify indexed, not a verified result. Open the source lines an answer cites before you rely on it. Some tools write workspace memory, so read each tool request before you approve it.

Troubleshooting

What you see	What to do
Graphify rejects the connection	You added the server but did not sign in. Run `codex mcp login graphify`.
`graphify` is missing from `/mcp`	Start a new Codex session after adding it, and check the `[mcp_servers.graphify]` entry in `config.toml`.
The tools return no repositories	The repository is not indexed yet, or it is in a different workspace. Check Repositories and builds.
Every Graphify tool appears twice	You have both the plugin and a manual server entry. Remove one.

FAQ

Do I need an API key to connect Codex to Graphify?

No. Codex signs in with OAuth in your browser the first time it connects. There is no key to paste or store.

Does Graphify read my local files from Codex?

No. The hosted server answers from repositories already indexed in your Graphify workspace. To build a graph from files on your machine instead, use the open-source package and its local skill.

Is the Graphify MCP server free?

Every new account starts on a 14-day Pro trial. After the trial, the Free plan keeps the hosted server available for up to 3 indexed repositories, with no card required. See Plans and pricing for Pro and Teams.

Should I use the plugin or codex mcp add?

Either works and both sign in with OAuth. The plugin is the quickest path. codex mcp add keeps the setup in your own config.toml.

This page installs the local skill. Codex builds the graph on your machine. To query a repository already indexed in Graphify, use ChatGPT, Codex, and Dots.

1. Install and register

uv tool install graphifyy
graphify install --platform codex

The integration installs the Graphify skill and AGENTS.md instructions. The current installer also supports Codex hook integration. Exact destinations depend on whether you use a personal or project installation; the installer reports the files it writes.For a repository-local setup, run this from the project root:

graphify install --project --platform codex

2. Build the graph

Open your project in Codex. Select the Graphify skill and enter:

$graphify map the current repository

The assistant runs the Graphify workflow and writes graphify-out/. Code extraction runs locally; semantic extraction can use your assistant’s model for documents and media.

3. Ask with context

After the graph is built, ask:

Use Graphify to explain the authentication flow. Cite the source files and distinguish explicit relationships from inferred ones.

You can also query from a terminal:

graphify query "authentication flow"

Keep it current

uv tool upgrade graphifyy
graphify install --platform codex

If the skill is missing, refresh the assistant and confirm that the registration was installed in the intended user or project scope. See troubleshooting.

Connect native MCP tools

Use the same graph through structured tool calls.

Graphify with Codex (local skill)

Build the graph on your machine with the open-source local skill instead.

How Graphify builds a code knowledge graph

What the graph contains and where its relationships come from.

Edges and provenance

Read what an answer’s relationships claim and how certain they are.

Code with an agent

Set up any agent from the console’s Connectors → MCP wizard.

Coding agents

Assistants

Source control

CI and deploy

Knowledge sources

For agents

Graphify for Codex

Before you start

1. Add the server

2. Check the connection

Optional: set a default repository

3. Ask a question

Troubleshooting

FAQ

Do I need an API key to connect Codex to Graphify?

Does Graphify read my local files from Codex?

Is the Graphify MCP server free?

Should I use the plugin or codex mcp add?

1. Install and register

2. Build the graph

3. Ask with context

Keep it current

Connect native MCP tools

Graphify with Codex (local skill)

How Graphify builds a code knowledge graph

Edges and provenance

Code with an agent

​Before you start

​1. Add the server

​2. Check the connection

​Optional: set a default repository

​3. Ask a question

​Troubleshooting

​FAQ

​Do I need an API key to connect Codex to Graphify?

​Does Graphify read my local files from Codex?

​Is the Graphify MCP server free?

​Should I use the plugin or codex mcp add?

​1. Install and register

​2. Build the graph

​3. Ask with context

​Keep it current

Connect native MCP tools

​Related

Graphify with Codex (local skill)

How Graphify builds a code knowledge graph

Edges and provenance

Code with an agent

Before you start

1. Add the server

2. Check the connection

Optional: set a default repository

3. Ask a question

Troubleshooting

FAQ

Do I need an API key to connect Codex to Graphify?

Does Graphify read my local files from Codex?

Is the Graphify MCP server free?

Should I use the plugin or codex mcp add?

1. Install and register

2. Build the graph

3. Ask with context

Keep it current

Related