Confirming MCP.json File Directory Locations | Warp | Page 1

earnest hemlock · 2025-10-27T01:55:44.022Z

Hi, I need confirmation on the directory locations for the mcp.json file when adding an MCP. macOS: ~/Library/Application Support/Warp/mcp.json Windows: %APPDATA%\Warp\mcp.json Linux: ~/.config/Warp/mcp.json Are these paths correct? There’s no official documentation about this, so I’d like to confirm.

#

Hi @earnest hemlock. I'm kapa.ai, your friendly support bot. I will try to answer your question by searching through the knowledge base. :wave:

#

Based on the knowledge sources, I need to clarify that MCP server configurations in Warp are not stored in a local mcp.json file by default.

According to the GitHub issue discussion, MCP server configurations are stored in the cloud along with other Warp Drive objects, not on disk. This allows you to have the same MCP servers configured across multiple devices.

As stated by a Warp team member in that discussion:

"they aren't stored on disk; they are stored in the cloud along with the other Warp Drive json objects. This is how you can have the same MCP servers configured on multiple devices"

The team also noted: "There are no plans for local MCP configuration storage at this time, but if / when we do it'll be in the docs."

What IS stored locally:

The only MCP-related files stored locally are MCP logs, which can be found at:

macOS: ~/Library/Application Support/dev.warp.Warp-Stable/mcp
Windows: %LOCALAPPDATA%\warp\Warp\data\logs\mcp
Linux: ${XDG_STATE_HOME:-$HOME/.local/state}/warp-terminal/mcp

These are documented in the MCP documentation.

So to answer your question: No, those paths are not correct because Warp does not currently store MCP configurations in a local `mcp.json` file. You configure MCP servers through the Warp UI (via Warp Drive > Personal > MCP Servers), and those configurations are synced via the cloud.

Note: you can ask me a follow up question by @ mentioning me again :speech_balloon:

#

@earnest hemlock Kapa.ai is still learning and improving, please let me know how I did by reacting below.

#Confirming MCP.json File Directory Locations

So to answer your question: No, those paths are not correct because Warp does not currently store MCP configurations in a local mcp.json file. You configure MCP servers through the Warp UI (via Warp Drive > Personal > MCP Servers), and those configurations are synced via the cloud.

Note: you can ask me a follow up question by @ mentioning me again :speech_balloon:

So to answer your question: No, those paths are not correct because Warp does not currently store MCP configurations in a local `mcp.json` file. You configure MCP servers through the Warp UI (via Warp Drive > Personal > MCP Servers), and those configurations are synced via the cloud.