{
  "mcpServers": {
    "google_workspace": {
      "command": "uvx",
      "args": ["workspace-mcp"],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "YOUR_CLIENT_ID.apps.googleusercontent.com",
        "GOOGLE_OAUTH_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
        "GOOGLE_EMAIL": "your-email@yourdomain.com",
        "OAUTHLIB_INSECURE_TRANSPORT": "1"
      },
      "_description": "Google Workspace MCP Server - Integrates Gmail, Google Drive, Docs, Sheets, Calendar, Tasks, Forms, Slides, and Chat",
      "_setup": [
        "1. Go to Google Cloud Console: https://console.cloud.google.com",
        "2. Create a new project or select existing one",
        "3. Enable APIs: Gmail API, Drive API, Docs API, Sheets API, Calendar API, Tasks API",
        "4. Go to 'Credentials' → 'Create Credentials' → 'OAuth 2.0 Client ID'",
        "5. Application type: 'Desktop app'",
        "6. Copy the Client ID and Client Secret",
        "7. Add authorized redirect URIs: http://localhost:8080/ and http://localhost:8080",
        "8. Set GOOGLE_EMAIL to your Google Workspace email address",
        "9. First run will open browser for OAuth consent - approve the permissions"
      ],
      "_documentation": "https://github.com/modelcontextprotocol/servers/tree/main/src/google-workspace"
    },

    "Ref": {
      "type": "http",
      "url": "https://api.ref.tools/mcp?apiKey=YOUR_REF_API_KEY",
      "_description": "Ref MCP Server - Search documentation from GitHub, web, and private sources. Provides accurate, up-to-date API documentation and code examples",
      "_setup": [
        "1. Visit: https://ref.tools",
        "2. Sign up for an account",
        "3. Go to Settings → API Keys",
        "4. Generate a new API key",
        "5. Replace YOUR_REF_API_KEY with your actual key in the URL"
      ],
      "_usage": [
        "Use ref_search_documentation to search for API docs, tutorials, and guides",
        "Use ref_read_url to read specific documentation pages",
        "Great for checking library documentation before implementing features"
      ],
      "_documentation": "https://ref.tools/docs"
    },

    "n8n-mcp": {
      "command": "npx",
      "args": ["-y", "n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://your-n8n-instance.com/api/v1",
        "N8N_API_KEY": "YOUR_N8N_API_KEY"
      },
      "_description": "n8n MCP Server - Integrates with n8n workflow automation platform. Create, read, update, and execute workflows programmatically",
      "_setup": [
        "1. Have an n8n instance running (self-hosted or n8n Cloud)",
        "2. Get your n8n instance URL (e.g., https://your-instance.up.railway.app)",
        "3. In n8n, go to Settings → API → API Keys",
        "4. Create a new API key",
        "5. Set N8N_API_URL to your instance URL + '/api/v1'",
        "6. Set N8N_API_KEY to your API key",
        "7. The server will be installed automatically via npx on first use"
      ],
      "_features": [
        "Search and browse n8n nodes and templates",
        "Create, update, and validate workflows",
        "Execute workflows and monitor executions",
        "Deploy templates directly to your n8n instance",
        "Auto-fix common workflow validation errors"
      ],
      "_documentation": "https://github.com/n8n-io/n8n-mcp"
    },

    "Baserow MCP": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.baserow.io/mcp/YOUR_BASEROW_TOKEN/sse"
      ],
      "_description": "Baserow MCP Server - No-code database platform integration. Read, create, update, and delete records in Baserow tables",
      "_setup": [
        "1. Have a Baserow account (baserow.io or self-hosted)",
        "2. Go to Settings → Account → API Tokens",
        "3. Create a new database token",
        "4. The token appears in the format: https://api.baserow.io/mcp/YOUR_TOKEN/sse",
        "5. Replace YOUR_BASEROW_TOKEN in the URL with your actual token",
        "6. Grant appropriate permissions to the token (read, create, update, delete)"
      ],
      "_usage": [
        "Use list_tables to see all available tables",
        "Use list_table_rows to browse table data",
        "Use create_row_table_* functions to add records",
        "Use update_row_table_* functions to modify records",
        "Use delete_table_row to remove records",
        "Search parameter available in list_table_rows for filtering"
      ],
      "_documentation": "https://baserow.io/docs/apis/mcp"
    }
  },

  "_general_notes": [
    "MCP (Model Context Protocol) servers extend Claude's capabilities with external integrations",
    "Copy this file to .mcp.json and replace all placeholder values with your actual credentials",
    "Keep .mcp.json in .gitignore - never commit credentials to version control",
    "Some servers require initial OAuth flows (like Google Workspace)",
    "You can enable/disable servers by adding/removing them from this config",
    "Restart Claude Code after modifying .mcp.json for changes to take effect"
  ],

  "_security_checklist": [
    "✓ Never commit .mcp.json to git (add to .gitignore)",
    "✓ Use environment variables for extra security if needed",
    "✓ Rotate API keys periodically",
    "✓ Grant minimum required permissions to API tokens",
    "✓ Review OAuth consent screens before approving",
    "✓ Keep this .mcp.json.example file updated when adding new servers"
  ]
}