# Trail

> Trail is a freemium MCP server for developer tools. Issue tracker and shared project memory your coding agent reads and writes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, Web, macOS, Windows, Linux
- **Website:** https://usetrail.dev
- **Repository:** https://github.com/arsprengel/trail-mcp
- **MCP Registry name:** dev.usetrail/trail
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-16

## About

Trail gives a coding agent a real team board and a store of durable project knowledge, both scoped to the folder you have open. The agent reads open items, records what it did and skipped, and logs decisions as it works, so a status update does not depend on anyone remembering. Every change on a card keeps its previous value, the time, and whether a person or their agent made it.

Project memory holds things like a release command that wipes a database, or a rule that prices are integer cents. These entries are shared by everyone on the project, and a session reads them before acting instead of rediscovering them. Reminders carry dates the agent closes or reschedules itself, and attachments hang off items.

The package is a client that talks to your Trail account over REST. On login it can install a session-start hook for Claude Code, Gemini CLI or Antigravity that loads open items and memory. Clients can get read-only logins with progress views, a request box and a signed PDF of what shipped. The free plan covers three projects and three people.

## Features

- **Agent-written tracker:** Items with type, status, priority, assignees and history.
- **Project memory:** Shared gotchas and decisions read at the start of each session.
- **Folder-scoped projects:** Uses the open folder, a .trail file or an environment variable.
- **Reminders:** Dated items the agent closes or reschedules.
- **Session hook:** Loads open items and memory into Claude Code, Gemini CLI or Antigravity.
- **Client view:** Read-only progress login with a request box.

## Good for

- Record what an agent skipped or decided during a session
- Warn future sessions about a dangerous release command
- Give a client read-only progress without status emails
- Track dated follow-ups an agent must not forget
- Keep two repositories' work separate

## Install

### Claude Code (Terminal)

```sh
claude mcp add trail -- npx -y usetrail
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "trail": {
      "command": "npx",
      "args": [
        "-y",
        "usetrail"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "trail": {
      "command": "npx",
      "args": [
        "-y",
        "usetrail"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "trail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "usetrail"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "trail": {
      "command": "npx",
      "args": [
        "-y",
        "usetrail"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "trail": {
      "command": "npx",
      "args": [
        "-y",
        "usetrail"
      ]
    }
  }
}
```

## Tools

- `list_items`: Lists tracker items.
- `get_item`: Fetches one item.
- `add_item`: Creates an item.
- `update_item`: Updates an item.
- `move_item`: Moves an item between statuses.
- `get_next`: Picks the next item to work on.
- `delete_item`: Deletes an item.
- `list_memory`: Lists project memory entries.
- `get_memory`: Reads one memory entry.
- `add_memory`: Adds a memory entry.
- `update_memory`: Edits a memory entry.
- `review_memory`: Reviews memory entries.
- `add_reminder`: Creates a reminder.
- `list_reminders`: Lists reminders.
- `update_reminder`: Updates a reminder.
- `delete_reminder`: Deletes a reminder.
- `add_attachment`: Attaches a file to an item.
- `get_attachment`: Fetches an attachment.

## FAQ

### How do I connect it?

Run npx -y usetrail@latest login, then register it with your agent, for example claude mcp add trail -s user -- npx -y usetrail@latest.

### What does the free plan include?

Three projects and three people, per the README.

### How does it pick a project?

From the open folder name, a .trail file, or the TRAIL_PROJECT variable.

### Can I self-host?

The TRAIL_API_URL variable points the connector at a self-hosted Trail.

### Is Trail free?

Trail has a free plan, with paid plans for more usage or features.

### How do I add Trail to Claude Code?

Run this command in your terminal: claude mcp add trail -- npx -y usetrail

### What are the best alternatives to Trail?

The closest alternatives to Trail are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/trail
