Set up Jira MCP in Windsurf

Interact with Jira projects and issues. Create, update, search, and manage issues and sprints from your AI editor.

Locate the config file

Windsurf reads MCP server configuration from the following file:

~/.codeium/windsurf/mcp_config.json

Create this file if it does not already exist.

Add the configuration

Add the following to your Windsurf config file:

json

{
  "mcpServers": {
    "jira-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "jira-mcp"
      ],
      "env": {
        "JIRA_URL": "YOUR_JIRA_URL",
        "JIRA_EMAIL": "YOUR_JIRA_EMAIL",
        "JIRA_API_TOKEN": "YOUR_JIRA_API_TOKEN"
      }
    }
  }
}

Set up environment variables

Jira MCP requires the following environment variables:

JIRA_URLRequired

Jira instance URL

JIRA_EMAILRequired

Jira account email

JIRA_API_TOKENRequired

Jira API token

Verify it works

Restart Windsurf. Jira MCP should appear in your MCP server list with 10 tools available.

This server adds approximately 5,150 tokens to your context window for tool definitions.

Set up Jira MCP in other editors

Claude Code Cursor VS Code Claude Desktop Continue

← Back to Jira MCP