# Ryphos

> Ryphos is a freemium MCP server for professional services. MCP server giving AI assistants access to Ryphos clients, projects, invoices and time. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web
- **Website:** https://ryphos.com/en/mcp-reference
- **MCP Registry name:** com.ryphos/ryphos
- **Categories:** [professional services](https://ai-powered.com/categories/professional-services)
- **Listing updated:** 2026-11-19

## About

The README-style reference for this server describes an MCP endpoint at a single streamable HTTP URL that lets Claude, ChatGPT, Cursor and similar clients work against a Ryphos company account. Access is granted through OAuth 2.1 or a personal connection key, and each connection only sees the companies and permissions the user approved when creating it.

The tool set covers clients, projects, milestones, tasks, time logs, appointments, expenses, the wiki and a personal memory folder. Invoicing tools can create drafts, issue invoices and record manual payments, but several actions require an explicit confirm flag, and the reference states there are no tools to delete issued invoices, invite users or change plans.

The server suits freelancers and small agencies who already run their business in Ryphos and want an assistant to look up data, draft invoices or log hours. Usage is metered in points per minute and per day, varying by plan, and the underlying company subscription is a separate paid product.

## Features

- **OAuth and key access:** Connects via OAuth 2.1 with PKCE or a revocable rk_ connection key stored as a hash.
- **Per-company isolation:** Each connection sees only the companies authorized at creation, and ids outside them return not found.
- **Scoped permissions:** Each connection gets read and write scopes, with sensitive scopes such as invoicing and app keys opt-in only.
- **Confirmation on sensitive actions:** Deletes, sends, issuing invoices and recording payments require confirm set to true.
- **Draft-first invoicing:** Invoices are created as drafts, and issuing or emailing them is a separate step.
- **Plan-based rate limits:** Points per minute and per day are set by plan, with 429 responses and Retry-After headers.

## Good for

- Ask an assistant for open tasks or time logged in a project
- Draft an invoice from recent milestones for review before issuing
- Check unpaid invoices and their totals for the month
- Log hours or start a timer from a coding or chat session
- Save meeting notes and create follow-up tasks in a project

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http ryphos https://api.ryphos.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.ryphos.com/mcp
```

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

```json
{
  "mcpServers": {
    "ryphos": {
      "url": "https://api.ryphos.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "ryphos": {
      "type": "http",
      "url": "https://api.ryphos.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ryphos": {
      "serverUrl": "https://api.ryphos.com/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://api.ryphos.com/mcp
```

Enter a Name (for example "Ryphos"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin. When we checked, this server asked for OAuth sign-in. If its docs give you an OAuth client ID and secret, enter them in the form's OAuth Client ID and Client Secret fields.

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

```json
{
  "mcpServers": {
    "ryphos": {
      "type": "http",
      "url": "https://api.ryphos.com/mcp"
    }
  }
}
```

## Tools

- `ryphos_list_clients`: Lists clients from all authorized companies or one.
- `ryphos_create_client`: Creates a client in an authorized company.
- `ryphos_list_projects`: Lists projects, optionally for one client or by status.
- `ryphos_create_project`: Creates a project for an existing client.
- `ryphos_list_tasks`: Lists tasks of a project, milestone or epic.
- `ryphos_create_task`: Creates a task in a project, milestone or under an epic.
- `ryphos_list_invoices`: Lists invoices from authorized companies, newest first.
- `ryphos_create_invoice`: Creates a draft invoice for a client.
- `ryphos_send_invoice`: Issues a draft invoice; requires confirm set to true.
- `ryphos_record_payment`: Records a manual payment of an invoice; requires confirm set to true.
- `ryphos_log_time`: Logs hours in the user's name on a project or task.
- `ryphos_start_timer`: Starts the user's timer.
- `ryphos_stop_timer`: Stops the active timer and logs the time.
- `ryphos_list_appointments`: Lists agenda appointments.
- `ryphos_create_appointment`: Creates a confirmed appointment.
- `ryphos_finances_summary`: Returns revenue, expenses and net in EUR.

## FAQ

### How does the server authenticate AI clients?

It supports OAuth 2.1 with dynamic client registration and PKCE for clients like Claude, ChatGPT, Cursor and VS Code, or a connection key (rk_) sent as a bearer header for clients such as Claude Code.

### Can the assistant delete invoices or clients?

The reference says there are no tools to delete invoices, payments or clients. Only draft invoices can be deleted, and only with confirm set to true.

### Does the assistant send invoices to customers automatically?

Issuing an invoice does not send email. Emailing an issued invoice is a separate tool that requires confirm set to true and only goes to the client or their contacts.

### Is there a free plan?

The pricing page lists a free memory plan with one memory and 200 pages, and a 14-day trial of the Business plan features. Trial and free companies can only create test keys that have no real effects.

### Is Ryphos free?

Ryphos has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

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

Run this command in your terminal: claude mcp add --transport http ryphos https://api.ryphos.com/mcp

### What are the best alternatives to Ryphos?

The closest alternatives to Ryphos are DataAutomation, ConsultBase, Freelance Act Order Lint Jp, cvwork — CV y ATS and Resumeily.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status: checked automatically by AIPoweredBot on 20 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [DataAutomation](https://ai-powered.com/mcp/dataautomation): DataAutomation is a paid MCP server for professional services.
- [ConsultBase](https://ai-powered.com/mcp/consultbase): ConsultBase is a freemium MCP server for professional services.
- [Freelance Act Order Lint Jp](https://ai-powered.com/mcp/freelance-act-order-lint-jp): Freelance Act Order Lint Jp is an open-source MCP server for legal and government.
- [cvwork — CV y ATS](https://ai-powered.com/mcp/cvwork-cv-y-ats): cvwork — CV y ATS is a free MCP server for professional services.
- [Resumeily](https://ai-powered.com/mcp/resumeily): Resumeily is an MCP server for professional services.
- [Matchaa](https://ai-powered.com/mcp/matchaa): Matchaa is a freemium MCP server for professional services.
- [Primer Market Systems (MSD) & DCED Engine](https://ai-powered.com/mcp/primer-market-systems-msd-and-dced-engine): Primer Market Systems (MSD) & DCED Engine is a free MCP server for professional services.
- [Virtual Assistant Capital](https://ai-powered.com/mcp/virtual-assistant-capital): Virtual Assistant Capital is a free MCP server for professional services.

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