Skip to content
Simply SF logoSimply SF logoSimply CLI

MCP server

simply atlassian mcp

Section titled “simply atlassian mcp”

Serve the Atlassian MCP tools over stdio.

Flags

  • --allow-writes — Also register the tools that change data.
  • --xray — Also register the Xray tools (Jira Server/Data Center, read-only).
  • -e, --env-file <value> — Path to a .env file holding connection settings.
  • --list — Print the tools that would be registered, then exit without serving.

Runs a Model Context Protocol server exposing Jira and Confluence as tools, for Claude Desktop, Claude Code, Cursor, Gemini CLI, VS Code, or any other MCP client. It speaks the protocol on stdout, so it is meant to be launched by a client rather than run by hand — at a terminal it will simply appear to hang, waiting for a client that is not there.

Point a client at it with “command”: “simply”, “args”: [“atlassian”, “mcp”]. The plugin installs itself on first use, so nothing needs installing beyond the simply CLI.

Only read tools are registered unless —allow-writes is passed, and ATLASSIAN_READ_ONLY still refuses every write even then.

Examples

Register only the read tools, taking settings from the environment

Terminal window
simply atlassian mcp

Allow writes, with settings from a file

Terminal window
simply atlassian mcp --allow-writes --env-file ~/atlassian.env

Also register the Xray tools, for Jira Server/Data Center with Xray installed

Terminal window
simply atlassian mcp --xray

List the tools this server would register, without starting it

Terminal window
simply atlassian mcp --list

simply atlassian mcp install

Section titled “simply atlassian mcp install”

Add the Atlassian MCP server to MCP clients.

Flags

  • --client <value> — Client to add the server to. Repeat for several. (one of: claude-code, claude-desktop, cursor, vscode, windsurf, gemini, codex; repeatable)
  • --scope <value> — Your own configuration, or the repository-level file in the current directory. (default: user; one of: user, project)
  • -e, --env-file <value> — Connection settings file for the server. Written as an absolute path.
  • --allow-writes — Register the tools that change data. Also makes the default name simply-atlassian-write.
  • --xray — Also register the Xray tools (Jira Server/Data Center).
  • --name <value> — Entry name. Default simply-atlassian, or simply-atlassian-write with —allow-writes.
  • --launcher <value> — How the entry starts simply. Default absolute for —scope user, simply for —scope project. (one of: absolute, simply, npx)
  • --force — Replace an existing entry of the same name that differs.
  • --dry-run — Show what would be written, and change nothing.

Global

  • --json — the raw API payload, for scripts and agents.

Writes an entry that launches “simply atlassian mcp” into each client named with —client, keeping the rest of that client’s configuration as it was. Claude Code and Codex are changed through their own CLIs; every other client’s JSON file is edited in place, with a .bak copy kept.

Credentials are never written. Give the server its connection settings with —env-file, which is written as an absolute path and must exist now. A GUI client will not pass on your shell’s environment, so without —env-file the entry starts with no settings.

Running it again is safe: an identical entry is left alone, and a different one is only replaced with —force.

Examples

Add the read-only server to Claude Code and Cursor

Terminal window
simply atlassian mcp install --client claude-code --client cursor --env-file ~/atlassian.env

Add a second, write-enabled entry (named simply-atlassian-write) to Claude Desktop

Terminal window
simply atlassian mcp install --client claude-desktop --allow-writes --env-file ~/atlassian-write.env

Commit an entry for this repository’s VS Code users

Terminal window
simply atlassian mcp install --client vscode --scope project

See what would be written, and change nothing

Terminal window
simply atlassian mcp install --client gemini --dry-run