Skip to main content
Glama

trac-mcp-server

Standalone MCP server that gives AI agents full access to Trac project management -- tickets, wiki, milestones, and search -- via the Model Context Protocol.

Quick Start

Requires Python 3.10 or later.

pip install .

Set your Trac connection:

export TRAC_URL="https://trac.example.com"
export TRAC_USERNAME="your-username"
export TRAC_PASSWORD="your-password"

Run the server:

trac-mcp-server

Using auto-pm? When trac-mcp-server is driven through auto-pm, auto-pm reads its connection settings from .auto_pm/config.yml in your project root (rather than the environment variables above). Run auto-pm setup in your project directory to generate the file; the resulting .auto_pm/config.yml carries trac.url, trac.username, a ${TRAC_PASSWORD} reference, and component mappings.

Related MCP server: ClickUp MCP Server

Configuration

Configuration via environment variables, .env file, or YAML config file (.trac_mcp/config.yaml):

Variable

Required

Default

Description

TRAC_URL

Yes

--

Trac instance URL

TRAC_USERNAME

Yes

--

Trac username

TRAC_PASSWORD

Yes

--

Trac password

TRAC_INSECURE

No

false

Skip SSL verification (development only)

TRAC_DEBUG

No

false

Enable debug logging

TRAC_MAX_PARALLEL_REQUESTS

No

5

Max parallel XML-RPC requests

TRAC_MAX_BATCH_SIZE

No

500

Max items per batch operation (1-10000)

For YAML config file format and advanced options, see Configuration Reference.

MCP Client Integration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "trac": {
      "command": "trac-mcp-server",
      "env": {
        "TRAC_URL": "https://trac.example.com",
        "TRAC_USERNAME": "your-username",
        "TRAC_PASSWORD": "your-password"
      }
    }
  }
}

Claude Code

claude mcp add trac -e TRAC_URL=https://trac.example.com \
  -e TRAC_USERNAME=your-username \
  -e TRAC_PASSWORD=your-password \
  -- trac-mcp-server

Other MCP Clients

Any MCP client that supports stdio transport can launch trac-mcp-server as a subprocess. Pass Trac credentials via environment variables.

Available Tools (42)

Tickets (11)

Tool

Description

ticket_search

Search tickets with Trac query language

ticket_get

Get ticket details by ID

ticket_create

Create new tickets

ticket_update

Update existing tickets

ticket_delete

Delete tickets

ticket_changelog

Get ticket change history

ticket_fields

List available ticket fields

ticket_actions

Get available ticket actions

ticket_batch_create

Create multiple tickets in one batch

ticket_batch_delete

Delete multiple tickets in one batch

ticket_batch_update

Update multiple tickets in one batch

Ticket Attachments (4)

Tool

Description

ticket_attachment_put

Upload a local file as an attachment to a ticket (bytes sent via XML-RPC, not inlined)

ticket_attachment_get

Download a ticket attachment to a local file (bytes written to output_path, not inlined)

ticket_attachment_list

List attachments on a ticket

ticket_attachment_delete

Delete a ticket attachment (requires TICKET_ADMIN)

Ticket Admin (6)

Tool

Description

ticket_component_create

Create a new ticket component (requires TICKET_ADMIN)

ticket_component_list

List all ticket components

ticket_component_delete

Delete a ticket component (requires TICKET_ADMIN)

ticket_enum_create

Create a new enum value (priority, resolution, severity, type, version) — requires TICKET_ADMIN

ticket_enum_list

List enum values for a given enum type

ticket_enum_delete

Delete an enum value (requires TICKET_ADMIN)

Wiki (7)

Tool

Description

wiki_get

Get wiki page content (with Markdown conversion)

wiki_search

Search wiki pages

wiki_create

Create new wiki pages

wiki_update

Update existing wiki pages

wiki_delete

Delete wiki pages

wiki_recent_changes

List recent wiki changes

wiki_get_history

Get version history for a wiki page

Wiki Files (3)

Tool

Description

wiki_file_push

Push local file to wiki (auto format conversion)

wiki_file_pull

Pull wiki page to local file

wiki_file_detect_format

Detect content format (Markdown/TracWiki)

Wiki Attachments (4)

Tool

Description

wiki_attachment_put

Upload a local file as an attachment to a wiki page (bytes sent via XML-RPC, not inlined)

wiki_attachment_get

Download a wiki attachment to a local file (bytes written to output_path, not inlined)

wiki_attachment_list

List attachments on a wiki page

wiki_attachment_delete

Delete a wiki attachment (requires WIKI_DELETE)

Milestones (5)

Tool

Description

milestone_list

List all milestones

milestone_get

Get milestone details

milestone_create

Create new milestones

milestone_update

Update existing milestones

milestone_delete

Delete milestones

System (2)

Tool

Description

ping

Test connectivity and return API version

get_server_time

Get Trac server time

Development

pip install -e ".[dev]"
pytest tests/ -v

Project Structure

src/trac_mcp_server/
  config.py       # Environment variable configuration
  core/           # Trac XML-RPC client, async utilities
  mcp/            # MCP server, tools, resources
  converters/     # Markdown <-> TracWiki conversion
  detection/      # Content format detection

Documentation

See docs/reference/overview.md for detailed tool reference, configuration, and troubleshooting.

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • Cross-agent artifact workspace with provenance across Claude Code, Codex, Cursor, LangGraph.

  • Manage projects, tasks, time tracking, and team collaboration through natural language.

View all MCP Connectors

Latest Blog Posts

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/nerpatech/trac-mcp-server'

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