Skip to content
MCP server

Django Admin MCP

Django package that exposes your admin models to MCP clients within Django permissions

Install
Pricing
Open source
Platforms
self-hosted, API
Runs
Remotely
Version
0.11.1
Listing updated
2 days ago

About Django Admin MCP

Django Admin MCP is an open-source MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

Instead of handing an agent a database connection, this package puts it behind the admin you already maintain. You add a mixin to a ModelAdmin and set mcp_expose = True, and tools are generated from that class: list, get, create, update and delete for the model, plus admin actions, history, autocomplete and related-object traversal. Models with the mixin but no flag can only be found through find_models.

Control stays in Django. Every call goes through the has_*_permission() checks, a token starts with no access and can never do more than its linked user, and writes run full_clean() and your save hooks so the agent cannot save what the admin form would reject. Each change is recorded in Django's LogEntry under the token's user, and mcp_fields and mcp_exclude_fields keep secrets and password hashes out of view.

It installs with pip, is mounted through a URL include and a migration, and needs Python 3.10 or newer, Django 3.2 to 6.0 and Pydantic 2. The only dependencies are Django and Pydantic, with no MCP SDK. Tokens are created in the admin. MIT licensed.

Install

Run in a terminal

claude mcp add django-admin-mcp --env host='<host>' -- uvx django-admin-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "django-admin-mcp": {
      "command": "uvx",
      "args": [
        "django-admin-mcp"
      ],
      "env": {
        "host": "<host>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "django-admin-mcp": {
      "command": "uvx",
      "args": [
        "django-admin-mcp"
      ],
      "env": {
        "host": "<host>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "django-admin-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "django-admin-mcp"
      ],
      "env": {
        "host": "<host>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "django-admin-mcp": {
      "command": "uvx",
      "args": [
        "django-admin-mcp"
      ],
      "env": {
        "host": "<host>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "django-admin-mcp": {
      "command": "uvx",
      "args": [
        "django-admin-mcp"
      ],
      "env": {
        "host": "<host>"
      }
    }
  }
}

Configuration

  • hostHostname of your Django deployment that mounts django_admin_mcp.urls (e.g. admin.example.com)Required

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

find_models
Finds models that have the mixin but no direct tools.
list_article
Lists records of an exposed model, with a limit.
get_article
Reads one record.
create_article
Creates a record.
update_article
Updates a record with given data.

What it does

Mixin-based exposure
Add one mixin and a flag to a ModelAdmin to generate its tools.
Permission-capped tokens
A token can only do what its linked user is allowed to do.
Validated writes
Writes run full_clean() and your save hooks.
Admin actions as tools
Registered actions, including two-step confirmations, become callable.
Audit trail
Changes land in Django's LogEntry under the token's user.
Field filtering
Include or exclude fields so secrets stay hidden.

Good for

  • Let an agent list and update records through the admin safely
  • Run a registered admin action like publish or refund from chat
  • Review a record's change history with an assistant
  • Expose only selected fields of a model to an agent

Pricing

Open source

Free, MIT licence

Prices change. Check 7tg.github.io before you buy.

Django Admin MCP FAQ

How do I install it?

pip install django-admin-mcp, add django_admin_mcp to INSTALLED_APPS, include its URLs and run migrate.

Which Django versions work?

Django 3.2 through 6.0, with Python 3.10 or newer.

How is access controlled?

Bearer tokens created in the Django admin, capped by the linked user's permissions.

Which licence?

MIT.

Is Django Admin MCP free?

Yes. Django Admin MCP is open source, so you can use and self-host it for free.

How do I add Django Admin MCP to Claude Code?

Run this command in your terminal: claude mcp add django-admin-mcp --env host='<host>' -- uvx django-admin-mcp

What are the best alternatives to Django Admin MCP?

The closest alternatives to Django Admin MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Django Admin MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools