Reever MCP Server

The Model Context Protocol (MCP) server provides a standardized interface that allows any compatible AI model or agent to access your Reever data in a simple and secure way.

Installation

npm install @reeverdev/mcp

The MCP server is centrally managed by Reever and supports both Streamable HTTP and Server-Sent Events (SSE) transports.

Endpoints

| Transport | URL | |-----------|-----| | HTTP (Recommended) | https://mcp.reever.app/mcp | | SSE | https://mcp.reever.app/mcp/sse |

Setup

ChatGPT

1. Go to Settings → Apps & Connectors → Advanced settings → Enable Developer mode
2. Go to Settings → Connectors → Create
3. Enter:
   • Connector name: Reever
   • Connector URL: https://mcp.reever.app/mcp
4. Save and enable the connector in new chats

Claude Desktop

Edit the configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "reever": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.reever.app/mcp"]
    }
  }
}

Restart Claude Desktop after saving the configuration.

Claude Web/App

For Claude Team, Enterprise, or Edu plans:

1. Navigate to Settings in the sidebar
2. Scroll to Integrations and click Add more
3. Enter:
   • Integration name: Reever
   • Integration URL: https://mcp.reever.app/mcp
4. Enable the integration in new chats

Claude Code

claude mcp add --transport http reever https://mcp.reever.app/mcp

Then run /mcp to verify the connection.

Manage servers:

claude mcp list          # List all servers
claude mcp remove reever # Remove server

Scopes:

• --scope local (default): Current project only
• --scope project: Shared via .mcp.json
• --scope user: All projects

Cursor

Install via deep link or search for "Reever" in the MCP tools page.

Visual Studio Code

1. Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
2. Search for MCP: Add Server
3. Select HTTP and enter: https://mcp.reever.app/mcp

Windsurf

Add to your Windsurf MCP config file:

{
  "mcpServers": {
    "reever": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.reever.app/mcp"]
    }
  }
}

Project Configuration

Create a .mcp.json file in your project root:

{
  "mcpServers": {
    "reever": {
      "type": "http",
      "url": "https://mcp.reever.app/mcp"
    }
  }
}

Authentication

After connecting, use the reever_login tool to authenticate with your Reever account. You'll need your email/username and password.

Example prompt: "Login to Reever with my email [email protected]"

Available Tools

Tasks

| Tool | Description | |------|-------------| | reever_get_tasks | Search and filter tasks | | reever_create_task | Create a new task | | reever_update_task | Update existing task | | reever_delete_task | Delete a task | | reever_toggle_completion | Toggle task completion | | reever_get_user_tasks | Get tasks assigned to user |

Lists

| Tool | Description | |------|-------------| | reever_get_lists | Get all task lists | | reever_create_list | Create a new list | | reever_update_list | Update existing list | | reever_delete_list | Delete a list |

Calendar

| Tool | Description | |------|-------------| | reever_get_calendars | Get all calendars | | reever_create_calendar | Create a new calendar | | reever_get_events | Get calendar events | | reever_create_event | Create a new event | | reever_update_event | Update existing event | | reever_delete_event | Delete an event |

Tags

| Tool | Description | |------|-------------| | reever_get_tags | Get all tags | | reever_create_tag | Create a new tag | | reever_update_tag | Update existing tag | | reever_delete_tag | Delete a tag | | reever_get_task_tags | Get tags for a task | | reever_set_task_tags | Set tags for a task |

Task Groups

| Tool | Description | |------|-------------| | reever_get_task_groups | Get all task groups | | reever_create_task_group | Create a new task group | | reever_update_task_group | Update existing task group | | reever_delete_task_group | Delete a task group | | reever_assign_tasks_to_group | Assign tasks to a group |

Steps

| Tool | Description | |------|-------------| | reever_create_step | Create a step for a task | | reever_update_step | Update existing step | | reever_delete_step | Delete a step |

Settings

| Tool | Description | |------|-------------| | reever_get_settings | Get user settings | | reever_update_settings | Update user settings |

Usage Examples

• "Show me all my tasks" - Lists all your tasks
• "Create a task called 'Review proposal' in my Work list" - Creates a new task
• "Mark the 'Send email' task as complete" - Toggles task completion
• "What's on my calendar this week?" - Shows upcoming events
• "Add a meeting tomorrow at 2pm" - Creates a calendar event
• "Show my high priority tasks" - Filters tasks by priority

Troubleshooting

Connection Issues

If you're having trouble connecting:

1. Clear cached authentication:

   rm -rf ~/.mcp-auth

2. Verify the endpoint is accessible:

   curl https://mcp.reever.app/health

3. Check your Node.js version (for local installations):

   node --version  # Should be 18+

WSL Users

If using Windows Subsystem for Linux, ensure you have an updated Node.js version installed within WSL.

Local Development

For development or self-hosting:

# Install from npm
npm install @reeverdev/mcp

# Or clone and install dependencies
npm install

# Start HTTP server
node server.js
# Server runs on http://localhost:3070

# Start stdio server (for local Claude Desktop)
node index.js

# Or use npx directly
npx @reeverdev/mcp

Docker

docker build -t reeverdev-mcp .
docker run -p 3070:3070 reeverdev-mcp

License

ISC License