Django Admin MCP server

django-admin-mcp

Expose Django admin models to MCP (Model Context Protocol) clients via HTTP. Add a mixin to your ModelAdmin classes and get instant access to CRUD operations, admin actions, model history, and more.

Features

• Only two dependencies — Django and Pydantic, nothing else. No MCP SDK, no extra HTTP stack, no supply-chain sprawl
• Token authentication — secure Bearer token auth with configurable expiry
• Django admin permissions — respects existing view/add/change/delete permissions
• Field filtering — control which fields are exposed via mcpfields and mcpexclude_fields
• Full CRUD — list, get, create, update, delete operations
• Admin actions — execute registered Django admin actions, including two-step confirmation flows
• Bulk operations — create, update, or delete multiple records at once
• Model introspection — describe model fields and relationships
• Related objects — traverse foreign keys and reverse relations
• Change history — access Django admin's history log
• Autocomplete — search suggestions for foreign key fields
• MCP Prompts & Resources — workflow guides plus read-only data access via models:// and data:// URIs

<!-- mcp-name: io.github.7tg/django-admin-mcp -->

Installation

pip install django-admin-mcp

Add to your Django project:

# settings.py
INSTALLED_APPS = [
    'django_admin_mcp',
    # ...
]

# urls.py
from django.urls import path, include

urlpatterns = [
    path('mcp/', include('django_admin_mcp.urls')),
    # ...
]

Run migrations to create the token model:

python manage.py migrate django_admin_mcp

Quick Start

1. Expose Your Models

Add the mixin to any ModelAdmin. Set mcp_expose = True to expose direct tools:

from django.contrib import admin
from django_admin_mcp import MCPAdminMixin
from .models import Article, Author

@admin.register(Article)
class ArticleAdmin(MCPAdminMixin, admin.ModelAdmin):
    mcp_expose = True  # Exposes list_article, get_article, etc.
    list_display = ['title', 'author', 'published']

Shortened. The full README is on GitHub.