Skip to main content

​
Overview

Tiro MCP Server uses OAuth 2.0 Authorization Code with PKCE and JWT tokens (HS256 algorithm) to provide secure, scoped access to your meeting notes. Authentication is handled through Google OAuth login. Your MCP client (Claude Code or Claude Desktop) automatically initiates the OAuth flow on first connection. After signing in with Google, a JWT access token is issued with mcp:notes:read scope and is valid for 180 days.
Currently, Tiro supports Google OAuth login only. Support for email/password login and Microsoft OAuth is planned for future releases.

​
Claude Code Setup

Claude Code is Anthropic’s official CLI tool that supports MCP servers with OAuth authentication natively.
The quickest way to add Tiro MCP Server:
claude mcp add --transport http tiro https://mcp.tiro.ooo/mcp
On first connection, Claude Code will automatically open your browser for Google OAuth sign-in.

​
Claude Desktop Setup

Claude Desktop connects to Tiro MCP Server using the mcp-remote proxy, which translates the streamable-http protocol into the stdio transport that Claude Desktop supports.
Prerequisites: Node.js must be installed. Verify that the npx command works in your terminal.

​
Configuration File Location

~/Library/Application Support/Claude/claude_desktop_config.json

​
Setup Steps

1

Add Tiro MCP Server

Open the configuration file and add:
claude_desktop_config.json
{
  "mcpServers": {
    "tiro": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tiro.ooo/mcp"]
    }
  }
}
If you already have other MCP servers configured, add the tiro entry inside the existing mcpServers object.
2

Restart Claude Desktop

Quit Claude Desktop completely and relaunch it (not just a window refresh — fully quit and restart).
3

Authenticate

On first connection, your browser will open for Google OAuth sign-in. After authentication, tokens are cached locally and Claude Desktop will reconnect automatically on future restarts.
4

Verify Connection

Ask Claude:
Are you connected to the Tiro MCP server?
Claude should confirm the connection and show available Tiro tools.

​
Token Expiration

Tokens are valid for 180 days. When a token expires, your MCP client will automatically trigger the OAuth flow again — just sign in with Google and you’re reconnected.

​
Next Steps

Explore Tools

Learn about the four available MCP tools

Troubleshooting

Solutions for common issues