Brings agents into local Xcode projects for file operations, project management and automated development tasks.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add xcode --env PROJECTS_BASE_DIR='<PROJECTS_BASE_DIR>' -- npx -y xcode-mcp-server~/.codex/config.toml
[mcp_servers.xcode]
command = "npx"
args = ["-y", "xcode-mcp-server"]
env = { PROJECTS_BASE_DIR = "<PROJECTS_BASE_DIR>" }
# codex mcp add xcode --env PROJECTS_BASE_DIR='<PROJECTS_BASE_DIR>' -- npx -y xcode-mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"xcode": {
"command": "npx",
"args": [
"-y",
"xcode-mcp-server"
],
"env": {
"PROJECTS_BASE_DIR": "<PROJECTS_BASE_DIR>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"xcode": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"xcode-mcp-server"
],
"env": {
"PROJECTS_BASE_DIR": "<PROJECTS_BASE_DIR>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"xcode": {
"command": "npx",
"args": [
"-y",
"xcode-mcp-server"
],
"env": {
"PROJECTS_BASE_DIR": "<PROJECTS_BASE_DIR>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"xcode": {
"command": "npx",
"args": [
"-y",
"xcode-mcp-server"
],
"env": {
"PROJECTS_BASE_DIR": "<PROJECTS_BASE_DIR>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"xcode": {
"command": "npx",
"args": [
"-y",
"xcode-mcp-server"
],
"env": {
"PROJECTS_BASE_DIR": "<PROJECTS_BASE_DIR>"
}
}
}
}Environment variables
PROJECTS_BASE_DIR
Replace the placeholders with your own credentials and keep them out of version control.