Which integrations are available for this server?

Provides tools to administer a Jira Cloud site, including managing custom fields, permission schemes, workflows, screens, issue-type schemes, groups, project roles, saved filters, and bulk operations.

How do I use Jira Admin MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Jira Admin MCP Server Add alice@example.com to the jira-developers group." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Jira Admin MCP Server

by its-qusai-nasr

Overview Schema Related Servers Score Discussions

Python

Remote

Jira Admin MCP Server

Python License: MIT MCP

A Model Context Protocol server that gives an AI assistant (Claude, Cursor, VS Code, or any MCP client) 78 purpose-built tools to administer a Jira Cloud site - not just read and create tickets, but the behind-the-scenes admin work: custom fields and where they appear, permission schemes, workflows, screens, issue-type schemes, groups, project roles, saved filters, and bulk operations.

Most Jira MCP servers cover everyday usage. This one covers administration, and adds safety rails (dry-run mode, shared-scheme detection, identity checks before group changes, actionable errors) so an agent can run real admin jobs end to end.

Built with FastMCP. Talks to the Jira Cloud REST API v3 with your own Atlassian email + API token.

Quick start

You need three things from your own Jira: a base URL, your account email, and an API token (create one here). The token inherits your Jira permissions, so for admin tasks use an account with the right access.

The easiest way to run an MCP server today is uv / uvx - it handles Python and dependencies for you, no manual virtualenv. Install uv first, then pick one of the options below.

Option A - run straight from GitHub (no clone needed)

Add this to your MCP client config (see client setup for file locations):

{
  "mcpServers": {
    "jira-admin": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/its-qusai-nasr/jira-admin-mcp", "jira-mcp"],
      "env": {
        "JIRA_BASE_URL": "https://your-company.atlassian.net",
        "JIRA_EMAIL": "you@your-company.com",
        "JIRA_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Option B - clone for development

git clone https://github.com/its-qusai-nasr/jira-admin-mcp
cd jira-admin-mcp
uv sync                 # creates .venv and installs deps from uv.lock
cp .env.example .env    # then edit .env with your Jira credentials
uv run jira-mcp         # starts the server over stdio

With a cloned checkout, point your client at it:

{
  "mcpServers": {
    "jira-admin": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/jira-admin-mcp", "jira-mcp"]
    }
  }
}

Related MCP server: Jira MCP

Configuration

The server reads its settings from environment variables (passed via the env block above, or from a .env file in the project directory when you run a local clone).

Variable	Required	Description
`JIRA_BASE_URL`	yes	Your Jira Cloud base URL, e.g. `https://your-company.atlassian.net`
`JIRA_EMAIL`	yes	The Atlassian account email that owns the API token
`JIRA_API_TOKEN`	yes	API token from https://id.atlassian.com/manage-profile/security/api-tokens
`JIRA_DRY_RUN`	no	`true` simulates all writes (POST/PUT/DELETE) and returns the payload that would be sent, without calling Jira. Defaults to `false`.

Tip: set JIRA_DRY_RUN=true for your first session. Every write tool will return a {"dry_run": true, "would_call": ...} preview so you can watch what the agent intends to do before letting it touch live data.

Client setup

Add the JSON block from the Quick start to your client's MCP config:

Claude Desktop - claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Claude Code - a .mcp.json file at your project root (or claude mcp add)
Cursor - ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project)
VS Code - .vscode/mcp.json (uses a top-level "servers" key instead of "mcpServers")

Restart the client after editing the config. The server appears as jira-admin with all 78 tools.

What you can ask for

Once connected, the assistant can do things like:

"Add alice@example.com to the jira-developers group."
"Scope the Team custom field to projects ENG and OPS only, for the Story and Bug issue types."
"Which projects share permission scheme 10789? I want to edit it without breaking the others."
"Move every Internal Task in project OPS to the Task type, then transition the open ones to In Progress."
"Create a saved filter for unresolved bugs assigned to me and share it with the developers group."
"Show me the change history for PROJ-123 and tell me who reopened it."

Tools (78 total)

Tool	Description
`jira_issues_search`	Search issues using JQL with pagination
`jira_issues_get`	Get single issue by key (summary or full detail)
`jira_issues_create`	Create issue with project, type, fields
`jira_issues_update`	Update fields on existing issue
`jira_issues_transition`	Transition to new status (auto-resolves transition ID)
`jira_issues_assign`	Assign/unassign issue
`jira_issues_get_transitions`	List available workflow transitions
`jira_issues_get_createmeta`	Get required fields for creating issues
`jira_issues_delete`	Delete an issue permanently
`jira_issues_link`	Create a link between two issues
`jira_issues_get_changelog`	Get audit history (who changed what)
`jira_issues_bulk_create`	Bulk create up to 50 issues

Tool	Description
`jira_comments_list`	List comments on an issue
`jira_comments_add`	Add comment (plain text auto-converted to ADF)

Tool	Description
`jira_users_search`	Search by email or display name
`jira_users_get`	Get user details + groups by account ID

Tool	Description
`jira_groups_list`	List groups with member counts
`jira_groups_get_members`	Get members of a group
`jira_groups_add_user`	Add user to group
`jira_groups_remove_user`	Remove user from group
`jira_groups_create`	Create a new group
`jira_groups_delete`	Delete a group

Tool	Description
`jira_projects_list`	List projects filtered by name/key
`jira_projects_get`	Get project details + issue types
`jira_projects_get_statuses`	All statuses grouped by issue type
`jira_projects_get_roles`	Roles with actors (users/groups)
`jira_projects_update_role`	Add/remove actors from project roles
`jira_projects_get_versions`	List versions/releases in a project
`jira_projects_create_version`	Create a new version/release
`jira_projects_get_features`	Get enabled/disabled features
`jira_projects_get_notification_scheme`	Get notification scheme
`jira_projects_get_categories`	List project categories

Tool	Description
`jira_permissions_list_schemes`	List all permission schemes
`jira_permissions_get_scheme`	Get scheme with all grants
`jira_permissions_add_grant`	Add permission grant to scheme
`jira_permissions_assign_scheme`	Assign scheme to project

Tool	Description
`jira_fields_search`	Search fields by name, find field IDs
`jira_fields_get_contexts`	Get contexts for a custom field
`jira_fields_get_options`	Get options for select/dropdown fields
`jira_fields_manage_options`	Add, update, or reorder field options
`jira_fields_create_context`	Create a context, optionally scoped to projects/issue types
`jira_fields_update_context`	Rename or re-describe a context
`jira_fields_delete_context`	Delete a context and its options
`jira_fields_assign_context_projects`	Scope a context to specific projects
`jira_fields_remove_context_projects`	Unscope projects from a context
`jira_fields_add_context_issuetypes`	Restrict a context to specific issue types
`jira_fields_remove_context_issuetypes`	Remove issue types from a context
`jira_fields_get_project_mapping`	Audit which projects each context covers

Tool	Description
`jira_filters_search`	Search saved JQL filters
`jira_filters_create`	Create a new saved JQL filter
`jira_filters_get`	Get a filter with owner + share permissions
`jira_filters_update`	Update name/JQL/description
`jira_filters_delete`	Delete a filter permanently
`jira_filters_change_owner`	Change a filter's owner
`jira_filters_get_shares`	List a filter's share permissions
`jira_filters_add_share`	Add a share (requires you own the filter)
`jira_filters_remove_share`	Remove a share permission
`jira_filters_force_add_share`	Add a share to a filter you don't own (owner-swap workaround)

Tool	Description
`jira_issue_link_types_list`	List available link types (Blocks, Relates, etc.)
`jira_statuses_search`	Search statuses across the instance

Tool	Description
`jira_workflows_search`	Search workflows by name
`jira_workflows_get_schemes`	List workflow schemes
`jira_workflows_get_scheme_mappings`	Issue type to workflow mappings
`jira_workflows_get_scheme_project_usages`	List projects using a scheme (shared-scheme safety check)
`jira_workflows_set_scheme_issuetype`	Map an issue type to a workflow
`jira_workflows_delete_scheme_issuetype`	Remove an issue type's workflow mapping
`jira_workflows_create_scheme_draft`	Create an editable draft of a scheme
`jira_workflows_publish_scheme_draft`	Publish a scheme draft, making it live

Tool	Description
`jira_issuetypes_list`	List issue types (optionally by project)
`jira_issuetypes_get_schemes`	List issue type schemes
`jira_issuetypes_get_scheme_mappings`	Issue types in a scheme
`jira_screens_list`	List screens
`jira_screens_get_fields`	Get fields on screen tabs
`jira_screens_get_schemes`	List screen schemes

Tool	Description
`jira_bulk_edit_issues`	Bulk edit fields on multiple issues
`jira_bulk_transition_issues`	Bulk transition issues to new status
`jira_tasks_get_status`	Poll a generic task or bulk-queue task by ID
`jira_tasks_cancel`	Request cancellation of a generic async task

Design notes

Consolidate, don't wrap - 78 workflow-oriented tools rather than a 1:1 mirror of every REST endpoint.
Dry run - JIRA_DRY_RUN=true makes all write ops return simulated payloads.
Response filtering - strips self, _links, avatarUrls, and similar noise so the agent sees only useful fields.
Detail levels - read tools take detail="summary" (default) or detail="full".
ADF auto-wrap - plain text in comments/descriptions is auto-converted to Atlassian Document Format.
Transition resolution - jira_issues_transition resolves a status name to its transition ID automatically.
Actionable errors - error messages say what went wrong and what to try next.
Token-auth scope - webhook endpoints (/webhook) are intentionally not wrapped; Atlassian restricts them to Connect / OAuth 2.0 apps that token auth cannot satisfy.

Testing locally

Inspect and call tools interactively with the MCP Inspector:

npx @modelcontextprotocol/inspector uvx --from . jira-mcp

Run the unit tests (no network calls):

uv sync --extra dev
uv run pytest
uv run ruff check .

Security

Never commit credentials. .env is gitignored; use the env block in your client config or your OS secret manager.
Least privilege. The API token acts as your Jira user. Use an account scoped to only what you need, especially for write/admin tools.
Start in dry-run. JIRA_DRY_RUN=true lets you review every intended write before going live.
See the official MCP security best practices.

Contributing

Issues and PRs welcome. See CONTRIBUTING.md.

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/its-qusai-nasr/jira-admin-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server