DocsToolsProductivity Integrations

Ryvos integrates with popular productivity platforms, giving the agent access to your email, calendar, documents, and project management tools. These integrations are implemented as native Rust tools within the single binary.

Google Workspace

Ryvos provides 6 tools for Gmail, Google Calendar, and Google Drive.

Setup

  1. Create a Google Cloud project at console.cloud.google.com
  2. Enable the APIs: Gmail API, Google Calendar API, Google Drive API
  3. Create OAuth 2.0 credentials (Desktop application type)
  4. Download the client credentials JSON file

Then configure Ryvos:

[integrations.google]
enabled = true
client_id = "${GOOGLE_CLIENT_ID}"
client_secret = "${GOOGLE_CLIENT_SECRET}"
redirect_uri = "http://localhost:8085/callback"

On first use, Ryvos opens a browser for OAuth consent. The refresh token is stored securely in ~/.ryvos/google_token.json.

Gmail Tools

gmail_search — Search messages with Gmail query syntax:

{
  "query": "from:boss@company.com subject:budget after:2026/03/01",
  "max_results": 10
}

gmail_read — Read a specific message. Returns subject, from, to, date, body text, and attachment names.

gmail_send — Send a message with to, subject, and body fields.

Google Calendar Tools

gcal_list_events — List events for a date range:

{
  "start": "2026-03-17T00:00:00Z",
  "end": "2026-03-17T23:59:59Z",
  "calendar_id": "primary"
}

gcal_create_event — Create an event with summary, start/end times, attendees, and description.

Google Drive Tools

gdrive_search — Search files by query, MIME type, and result count.

Notion

Ryvos provides 4 tools for Notion workspace access.

Setup

  1. Create an integration at notion.so/my-integrations
  2. Copy the Internal Integration Token
  3. Share pages/databases with your integration
[integrations.notion]
enabled = true
api_key = "${NOTION_API_KEY}"

Notion Tools

  • notion_search — Search pages and databases by query
  • notion_read_page — Read a page's content as structured blocks
  • notion_create_page — Create a new page with title and markdown content
  • notion_update_page — Update an existing page's content

Jira

Ryvos provides 3 tools for Jira project management.

Setup

  1. Generate an API token at id.atlassian.com/manage/api-tokens
  2. Note your Jira domain (e.g., yourcompany.atlassian.net)
[integrations.jira]
enabled = true
domain = "yourcompany.atlassian.net"
email = "${JIRA_EMAIL}"
api_token = "${JIRA_API_TOKEN}"

Jira Tools

  • jira_search — Search with JQL (e.g., project = CORE AND status = 'In Progress')
  • jira_create_issue — Create issues with project, type, summary, description, priority, assignee, labels
  • jira_update_issue — Update status, add comments, change fields

Linear

Ryvos provides 3 tools for Linear project management.

Setup

  1. Generate an API key at linear.app/settings/api
[integrations.linear]
enabled = true
api_key = "${LINEAR_API_KEY}"

Linear Tools

  • linear_search — Search issues by query, team, and status
  • linear_create_issue — Create issues with title, description, team, priority, assignee, labels
  • linear_update_issue — Update status, add comments

Usage Examples

Once configured, the integrations work naturally through conversation:

You > What meetings do I have today?
Agent > [tool: gcal_list_events] Checking your calendar...

You have 3 meetings today:
1. 10:00-10:30 — Daily standup (Google Meet)
2. 14:00-15:00 — Sprint planning (Conference Room B)
3. 16:00-16:30 — 1:1 with Sarah

You > Create a Jira ticket for the auth bug we discussed in standup
Agent > [tool: jira_create_issue] Creating issue...

Created CORE-156: "Auth token refresh fails during long-running tasks"
Priority: High, assigned to you, labeled [auth, bug]

Security Considerations

:::caution Productivity integration tools have access to your email, calendar, documents, and project management data. Tools that send emails or create content are classified at T2 for the agent's constitutional safety reasoning. :::

Next Steps

Built-in Tools (86+)Custom Tools & Skills