Skip to content

Instantly share code, notes, and snippets.

@newsbubbles
Created September 10, 2025 17:36
Show Gist options
  • Select an option

  • Save newsbubbles/3ee6260672f1d69b032a794cea659cfc to your computer and use it in GitHub Desktop.

Select an option

Save newsbubbles/3ee6260672f1d69b032a794cea659cfc to your computer and use it in GitHub Desktop.
{
"tags": [
"jira",
"project management",
"issue tracking",
"atlassian",
"workflow"
],
"version": "1.0.0",
"filename": "mcp_server.py",
"capabilities": [
"get_project",
"create_project",
"update_project",
"delete_project",
"search_projects",
"archive_project",
"restore_project",
"create_issue",
"get_issue",
"update_issue",
"delete_issue",
"search_issues",
"count_issues",
"get_comments",
"add_comment",
"update_comment",
"delete_comment",
"get_attachments",
"delete_attachment",
"get_worklogs",
"add_worklog",
"get_current_user",
"get_user",
"search_users",
"get_project_versions",
"get_project_components"
],
"auth_methods": ["basic","oauth","pat"],
"required_env_vars": {
"JIRA_AUTH_METHOD": {
"description": "Authentication method to use",
"required": true,
"type": "enum",
"options": [
"basic",
"oauth",
"pat"
],
"default": "basic",
"sensitive": false
},
"JIRA_SITE_URL": {
"description": "Jira site URL (e.g., https://your-domain.atlassian.net)",
"required": true,
"type": "url",
"sensitive": false
},
"JIRA_EMAIL": {
"description": "Email address for Basic Auth",
"required": false,
"required_when": {
"JIRA_AUTH_METHOD": "basic"
},
"tab": "basic",
"type": "string",
"sensitive": false
},
"JIRA_API_TOKEN": {
"description": "API token for Basic Auth or PAT auth. Get one at https://id.atlassian.com/manage-profile/security/api-tokens",
"required": false,
"required_when": {
"JIRA_AUTH_METHOD": [
"basic",
"pat"
]
},
"tab": ["basic","pat"],
"type": "string",
"sensitive": true
},
"JIRA_ACCESS_TOKEN": {
"description": "Jira OAuth access token (auto-generated and auto-refreshed)",
"required": false,
"required_when": {
"JIRA_AUTH_METHOD": "oauth"
},
"tab": "oauth",
"type": "string",
"sensitive": true,
"oauth_credential": true,
"auto_generated": true,
"scope": "user",
"setup_instructions": "This token is automatically managed by the OAuth service. No manual setup required."
},
"JIRA_OAUTH_REFRESH_TOKEN": {
"description": "Jira OAuth refresh token (auto-generated via OAuth flow)",
"required": false,
"required_when": {
"JIRA_AUTH_METHOD": "oauth"
},
"tab": "oauth",
"type": "string",
"sensitive": true,
"oauth_credential": true,
"auto_generated": true,
"scope": "user",
"setup_instructions": "This token is automatically generated when you complete the OAuth flow. Click ''Connect with Jira'' to authenticate."
},
"JIRA_CLOUD_ID": {
"description": "Jira Cloud ID for API URL when using OAuth",
"required": false,
"required_when": {
"JIRA_AUTH_METHOD": "oauth"
},
"tab": "oauth",
"type": "string",
"sensitive": false
}
},
"oauth_config": {
"provider_name": "atlassian",
"authorization_url": "https://auth.atlassian.com/authorize",
"token_url": "https://auth.atlassian.com/oauth/token",
"scopes": [
"read:jira-work",
"write:jira-work",
"manage:jira-project",
"manage:jira-configuration"
],
"user_token_vars": {
"refresh_token": "JIRA_OAUTH_REFRESH_TOKEN",
"access_token": "JIRA_ACCESS_TOKEN"
},
"additional_params": {
"audience": "api.atlassian.com"
},
}
}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment