rahulvramesh/rytnow-mcp

Rytnow MCP Server

An MCP (Model Context Protocol) server that exposes Rytnow project management capabilities to AI assistants like Claude Code.

Documentation

• - Complete reference for all 27 available tools
• - Setup for Claude Code, Cursor, and more
• - Real-world workflows and automation examples

Features

• Workspace & Project Navigation: List workspaces, projects, and team members
• Task Management: Create, update, and manage tasks with full CRUD support
• Plan Management: Create feature plans and link tasks to them
• Time Tracking: Start/stop timers and log time entries
• Comments: Add and list task comments
• Subtasks: Create and manage task subtasks

Installation

Option 1: Pre-built Binary (Recommended)

Download the latest binary for your platform from GitHub Releases:

# Example for Linux/macOS
chmod +x rytnow-mcp-linux-x64
./rytnow-mcp-linux-x64

Option 2: From Source (requires Bun)

# Clone the repository
git clone https://github.com/rahulvramesh/rytnow-mcp.git
cd rytnow-mcp

# Install dependencies
bun install

# Run directly
bun run start

# Or build a binary for your platform
bun run build

Configuration

1. Generate an API Token

Get your Rytnow API token from:

• Web UI: Go to Settings → API Tokens → Generate New Token
• API: POST /api/v1/auth/token with email and password

2. Configure Claude Code

Add to your Claude Code configuration file (~/.claude/config.json or .claude/settings.json):

Using pre-built binary:

{
  "mcpServers": {
    "rytnow": {
      "command": "/path/to/rytnow-mcp-linux-x64",
      "env": {
        "RYTNOW_API_URL": "https://rytnow.me/api/v1",
        "RYTNOW_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Using Bun (from source):

{
  "mcpServers": {
    "rytnow": {
      "command": "bun",
      "args": ["run", "/path/to/rytnow-mcp/src/index.ts"],
      "env": {
        "RYTNOW_API_URL": "https://rytnow.me/api/v1",
        "RYTNOW_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

For local development:

{
  "mcpServers": {
    "rytnow": {
      "command": "bun",
      "args": ["run", "/path/to/rytnow-mcp/src/index.ts"],
      "env": {
        "RYTNOW_API_URL": "http://localhost:8000/api/v1",
        "RYTNOW_API_TOKEN": "your-local-token"
      }
    }
  }
}

Available Tools

Workspace & Projects

Tasks

Plans

Time Tracking

Comments

Available Resources

Usage Examples

Once configured, you can use natural language in Claude Code:

"List all my workspaces"
"Show me tasks in project 1"
"Create a task called 'Fix login bug' with high priority"
"Start timer on task 123"
"Mark task 123 as done"
"Create a plan for the authentication feature"

Development

# Run in development mode (with hot reload)
bun run dev

# Type check
bun run typecheck

# Build binary for current platform
bun run build

# Build binaries for all platforms
bun run build:all

Environment Variables

License

MIT