Better Auth MCP Server

by nahmanmate

16 stars

1 downloads

Not rated

GitHub

About

Enables enterprise-grade authentication management with secure credential handling and support for multi-protocol auth, complete with tools for analyzing, setting up, and testing authentication systems.

Details

Author: nahmanmate
Repository: jamesjohnsdev/better-auth-mcp-server
GitHub stars: 16
Downloads: 1
License: GNU Affero General Public License v3.0
Categories: Developer Tools, Security, API, Workplace

- Secure credential management with AES-256 encryption
- Multi-protocol authentication (OAuth2, SAML, LDAP)
- Real-time threat detection and prevention
- Tools for analyzing, setting up, and migrating auth systems
- Resources for inspecting current config and logs
- OWASP-aligned security testing and monitoring

Setting up with Highlight

Follow these steps to add this server as a custom Highlight plugin:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Better Auth MCP Server

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /path/to/better-auth-mcp-server/build/index.js
Environment
- BETTER_AUTH_API_KEY your-api-key
- BETTER_AUTH_PROJECT_ID your-project-id
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "better auth mcp server": {
            "env": {
                "BETTER_AUTH_API_KEY": "your-api-key",
                "BETTER_AUTH_PROJECT_ID": "your-project-id"
            },
            "args": [
                "/path/to/better-auth-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "better auth mcp server": {
            "env": {
                "BETTER_AUTH_API_KEY": "your-api-key",
                "BETTER_AUTH_PROJECT_ID": "your-project-id"
            },
            "args": [
                "/path/to/better-auth-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "better auth mcp server": {
            "env": {
                "BETTER_AUTH_API_KEY": "your-api-key",
                "BETTER_AUTH_PROJECT_ID": "your-project-id"
            },
            "args": [
                "/path/to/better-auth-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "better auth mcp server": {
            "env": {
                "BETTER_AUTH_API_KEY": "your-api-key",
                "BETTER_AUTH_PROJECT_ID": "your-project-id"
            },
            "args": [
                "/path/to/better-auth-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "better auth mcp server": {
            "env": {
                "BETTER_AUTH_API_KEY": "your-api-key",
                "BETTER_AUTH_PROJECT_ID": "your-project-id"
            },
            "args": [
                "/path/to/better-auth-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "better auth mcp server": {
            "env": {
                "BETTER_AUTH_API_KEY": "your-api-key",
                "BETTER_AUTH_PROJECT_ID": "your-project-id"
            },
            "args": [
                "/path/to/better-auth-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "better auth mcp server": {
            "env": {
                "BETTER_AUTH_API_KEY": "your-api-key",
                "BETTER_AUTH_PROJECT_ID": "your-project-id"
            },
            "args": [
                "/path/to/better-auth-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "better auth mcp server": {
            "env": {
                "BETTER_AUTH_API_KEY": "your-api-key",
                "BETTER_AUTH_PROJECT_ID": "your-project-id"
            },
            "args": [
                "/path/to/better-auth-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "better auth mcp server": {
            "env": {
                "BETTER_AUTH_API_KEY": "your-api-key",
                "BETTER_AUTH_PROJECT_ID": "your-project-id"
            },
            "args": [
                "/path/to/better-auth-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "better auth mcp server": {
            "env": {
                "BETTER_AUTH_API_KEY": "your-api-key",
                "BETTER_AUTH_PROJECT_ID": "your-project-id"
            },
            "args": [
                "/path/to/better-auth-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "better auth mcp server": {
            "env": {
                "BETTER_AUTH_API_KEY": "your-api-key",
                "BETTER_AUTH_PROJECT_ID": "your-project-id"
            },
            "args": [
                "/path/to/better-auth-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "better auth mcp server": {
            "env": {
                "BETTER_AUTH_API_KEY": "your-api-key",
                "BETTER_AUTH_PROJECT_ID": "your-project-id"
            },
            "args": [
                "/path/to/better-auth-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "better auth mcp server": {
            "env": {
                "BETTER_AUTH_API_KEY": "your-api-key",
                "BETTER_AUTH_PROJECT_ID": "your-project-id"
            },
            "args": [
                "/path/to/better-auth-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "better auth mcp server": {
            "env": {
                "BETTER_AUTH_API_KEY": "your-api-key",
                "BETTER_AUTH_PROJECT_ID": "your-project-id"
            },
            "args": [
                "/path/to/better-auth-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "better auth mcp server": {
            "env": {
                "BETTER_AUTH_API_KEY": "your-api-key",
                "BETTER_AUTH_PROJECT_ID": "your-project-id"
            },
            "args": [
                "/path/to/better-auth-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

From the repository

To install Better Auth MCP Server for Claude Desktop automatically via Smithery:

bash
npx -y @smithery/cli install @nahmanmate/better-auth-mcp-server --client claude

To use with Claude Desktop, add the server config: On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

json
{
"mcpServers": {
"better-auth-mcp-server": {
"command": "node",
"args": ["/path/to/better-auth-mcp-server/build/index.js"],
"disabled": false,
"alwaysAllow": []
}
}
}

typescript
// Initialize Better-Auth in your project
await mcp.useTool('setup_better_auth', {
projectPath: './my-next-app',
config: {
projectId: process.env.BETTER_AUTH_PROJECT_ID,
apiKey: process.env.BETTER_AUTH_API_KEY
}
});

// Test core authentication flows
await mcp.useTool('test_auth_flows', {
flows: ['login', 'register', '2fa']
});
```

`analyze_project`

Analyze project structure for auth setup recommendations.

`setup_better_auth`

Configure auth providers with project ID and API key.

`analyze_current_auth`

Detect existing auth.js/next-auth implementations.

`generate_migration_plan`

Create step-by-step migration path.

`test_auth_flows`

Validate login/register/reset/2fa flows.

`test_security`

Run OWASP-aligned security checks.

`analyze_logs`

Review auth system logs for issues.

`monitor_auth_flows`

Real-time authentication monitoring.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "better auth mcp server": {
            "env": {
                "BETTER_AUTH_API_KEY": "your-api-key",
                "BETTER_AUTH_PROJECT_ID": "your-project-id"
            },
            "args": [
                "/path/to/better-auth-mcp-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

Linux

{
    "env": {
        "BETTER_AUTH_API_KEY": "your-api-key",
        "BETTER_AUTH_PROJECT_ID": "your-project-id"
    },
    "args": [
        "/path/to/better-auth-mcp-server/build/index.js"
    ],
    "command": "node"
}

Macos

{
    "env": {
        "BETTER_AUTH_API_KEY": "your-api-key",
        "BETTER_AUTH_PROJECT_ID": "your-project-id"
    },
    "args": [
        "/path/to/better-auth-mcp-server/build/index.js"
    ],
    "command": "node"
}

Windows

{
    "env": {
        "BETTER_AUTH_API_KEY": "your-api-key",
        "BETTER_AUTH_PROJECT_ID": "your-project-id"
    },
    "args": [
        "/path/to/better-auth-mcp-server/build/index.js"
    ],
    "command": "node"
}

better-auth-mcp-server MCP Server

MCP Server for Authentication Management

Enterprise-grade authentication solution providing:

- 🔐 Secure credential management with AES-256 encryption
- ⚙️ Multi-protocol auth (OAuth2, SAML, LDAP)
- 🛡️ Real-time threat detection and prevention

Features

Core Tools

- analyze_project - Analyze project structure for auth setup recommendations - setup_better_auth - Configure auth providers with project ID and API key - analyze_current_auth - Detect existing auth.js/next-auth implementations - generate_migration_plan - Create step-by-step migration path

Testing & Security

- test_auth_flows - Validate login/register/reset/2fa flows - test_security - Run OWASP-aligned security checks - analyze_logs - Review auth system logs for issues - monitor_auth_flows - Real-time authentication monitoring

Available Resources

- better-auth://config - Current Better-Auth configuration settings - better-auth://logs - Authentication system logs

Development

Clone and install:

git clone https://github.com/better-auth-mcp-server/better-auth-mcp-server.git

cd better-auth-mcp-server

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Configuration

Environment Variables

# Required
BETTER_AUTH_PROJECT_ID=your-project-id
BETTER_AUTH_API_KEY=your-api-key
Optional
BETTER_AUTH_ENV=development|staging|production
LOG_LEVEL=info|debug|error

Security Best Practices

1. API Key Management
- Store API keys in environment variables
- Rotate keys regularly
- Use different keys per environment

2. Access Control
- Implement rate limiting
- Configure IP allowlists
- Use principle of least privilege

3. Monitoring
- Enable audit logging
- Monitor auth failures
- Set up alerts for suspicious activity

Installation

Installing via Smithery

To install Better Auth MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @nahmanmate/better-auth-mcp-server --client claude

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "better-auth-mcp-server": {
      "command": "node",
      "args": ["/path/to/better-auth-mcp-server/build/index.js"],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Usage Examples

Project Setup

// Initialize Better-Auth in your project
await mcp.useTool('setup_better_auth', {
  projectPath: './my-next-app',
  config: {
    projectId: process.env.BETTER_AUTH_PROJECT_ID,
    apiKey: process.env.BETTER_AUTH_API_KEY
  }
});
// Test core authentication flows

await mcp.useTool('test_auth_flows', {

  flows: ['login', 'register', '2fa']

});

Migration from Auth.js/NextAuth

// Analyze current auth implementation
await mcp.useTool('analyze_current_auth', {
  projectPath: './my-next-app'
});
// Generate migration steps

await mcp.useTool('generate_migration_plan', {

  projectPath: './my-next-app',

  currentAuthType: 'next-auth'

});

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

analyze_project

setup_better_auth

analyze_current_auth

generate_migration_plan

test_auth_flows

test_security

analyze_logs

monitor_auth_flows

Claude Desktop / Cursor

Linux

Macos

Windows

better-auth-mcp-server MCP Server

Features

Core Tools

Testing & Security

Available Resources

Development

Configuration

Environment Variables

Optional

Security Best Practices

Installation

Installing via Smithery

Debugging

Usage Examples

Project Setup

Migration from Auth.js/NextAuth

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright

`analyze_project`

`setup_better_auth`

`analyze_current_auth`

`generate_migration_plan`

`test_auth_flows`

`test_security`

`analyze_logs`

`monitor_auth_flows`