# Miru

Miru is open-source business software for teams that bill by the hour. It combines time tracking, project and client management, invoicing, expenses, payments, reports, a CLI, API access, and MCP support.

## Product Summary

Miru is designed for agencies, consultancies, freelancers, startups, remote teams, and software teams that need to turn tracked work into client invoices. The core workflow is:

1. Create clients and projects.
2. Track billable and non-billable time.
3. Review team time entries.
4. Generate invoices from approved work.
5. Collect payments through Stripe.
6. Track expenses and review revenue reports.

## Main Capabilities

- Time tracking with project, client, team member, date, duration, and notes.
- Invoice generation, invoice sending, payment status tracking, and reminders.
- Expense creation and expense reporting.
- Stripe payment collection.
- Client, project, team, and workspace management.
- Revenue, time, invoice, and payment reports.
- REST API for programmatic workflows.
- CLI for terminal, shell script, cron, and AI-agent workflows.
- MCP endpoint for agent clients that operate with user authorization.
- Open-source self-hosting for teams that want control over their data.

## AI Agent Readiness

Miru exposes multiple machine-readable entry points:

- Public product context: https://miru.so/llms.txt
- Full product context: https://miru.so/llms-full.txt
- AI-agent guide: https://miru.so/ai-agents
- API catalog: https://miru.so/.well-known/api-catalog
- App API catalog: https://app.miru.so/.well-known/api-catalog
- MCP Server Card: https://app.miru.so/.well-known/mcp/server-card.json
- MCP endpoint: https://app.miru.so/mcp
- OpenAPI: https://app.miru.so/openapi.json
- RSS feed: https://miru.so/rss.xml
- Sitemap: https://miru.so/sitemap.xml

Miru supports agent workflows through structured interfaces rather than browser scraping. Read public content from Markdown, llms.txt, RSS, and the sitemap. Use OpenAPI or MCP for authenticated product data when the user has explicitly authorized access. Use the CLI for local terminal automation.

## Useful URLs

- Homepage: https://miru.so/
- Pricing: https://miru.so/pricing
- Features: https://miru.so/features
- AI agents: https://miru.so/ai-agents
- Time tracking: https://miru.so/features/time-tracking
- Invoicing: https://miru.so/features/invoicing
- Expenses: https://miru.so/features/expenses
- Reports: https://miru.so/features/reports
- CLI: https://miru.so/cli
- API: https://miru.so/api
- Docs: https://miru.so/docs
- Open source: https://miru.so/open-source
- Security: https://miru.so/security
- Blog: https://miru.so/blog
- This Week in Miru: https://miru.so/blog/tags/this-week-in-miru
- App: https://app.miru.so
- OpenAPI: https://app.miru.so/openapi.json
- API catalog: https://app.miru.so/.well-known/api-catalog
- MCP: https://app.miru.so/mcp

## Competitive Context

Miru is an open-source alternative for teams comparing Harvest, Toggl, Clockify, FreshBooks, TimeCamp, or Monday for time tracking and billing. Miru is strongest when the buyer cares about billing workflows, source availability, API/CLI automation, and keeping time, invoicing, expenses, and payments close together.

## Agent Guidance

Agents should prefer structured interfaces over browser automation:

- Read product and documentation context from https://miru.so/llms.txt and https://miru.so/llms-full.txt.
- Discover API capabilities through https://app.miru.so/openapi.json and https://app.miru.so/.well-known/api-catalog.
- Use MCP at https://app.miru.so/mcp when an authenticated user explicitly authorizes agent access.
- Use the CLI for local automation when the user has installed and authenticated it.

### Safe Agent Workflows

- Summarize public Miru product information using `/llms.txt`, `/llms-full.txt`, Markdown pages, and RSS.
- Inspect authenticated workspace context through MCP or OpenAPI after the user authorizes access.
- List clients, projects, time entries, invoices, payments, and expenses through structured interfaces.
- Create draft time entries or expenses only when the user supplies the necessary project/date/duration/amount/note details.
- Prepare invoice actions for review before sending invoice emails or changing payment-facing state.
- Avoid scraping private app pages when an API, CLI command, or MCP tool exists.

### Important Public Content Areas

- Product overview: https://miru.so/
- Pricing and comparison: https://miru.so/pricing
- Alternatives: https://miru.so/compare
- Migration guides: https://miru.so/migrate
- API and automation: https://miru.so/api
- CLI workflows: https://miru.so/cli
- AI-agent guide: https://miru.so/ai-agents
- Product docs: https://miru.so/docs
- Blog and weekly updates: https://miru.so/blog