Strety MCP Server

MCP (Model Context Protocol) server for integrating Strety with Claude Code.

Features

• Read tools: List todos (filtered by assignee, completion status), get todo details, list people
• Write tools: Create, update, complete/uncomplete, and delete todos
• Auto-refresh OAuth tokens
• Automatic ETag handling for PATCH operations
• Assignee name resolution (partial match, e.g., "Brent" resolves to full ID)

Installation

cd /Users/brent/scripts/CB-Workspace/mcp-servers/strety
npm install
npm run build

Configuration

1. Create Strety OAuth App

1. Go to https://2.strety.com
2. Navigate to: My Integrations > My Apps
3. Create new app with:
   • Name: Strety-MCP
   • Redirect URI: https://localhost:8888/callback
   • Scopes: read, write

2. Get OAuth Tokens

See todo/strety-oauth-flow.md for detailed instructions.

Quick version:

# Terminal 1: Start listener
nc -l 8888

# Terminal 2: Open this URL (replace CLIENT_ID)
# https://2.strety.com/oauth/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=https://localhost:8888/callback&response_type=code&scope=read+write

# Exchange code for token
curl -X POST "https://2.strety.com/api/v1/oauth/token" \
  -d "grant_type=authorization_code" \
  -d "code=CODE_FROM_CALLBACK" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "redirect_uri=https://localhost:8888/callback"

3. Save Tokens

mkdir -p ~/.mcp-strety
cat > ~/.mcp-strety/token.json << 'EOF'
{
  "access_token": "YOUR_ACCESS_TOKEN",
  "refresh_token": "YOUR_REFRESH_TOKEN",
  "saved_at": "2026-01-27T00:00:00.000Z"
}
EOF

4. Add to Claude Code

Add to ~/.mcp.json or project .mcp.json:

{
  "mcpServers": {
    "strety": {
      "command": "node",
      "args": ["/Users/brent/scripts/CB-Workspace/mcp-servers/strety/dist/index.js"],
      "env": {
        "STRETY_ACCESS_TOKEN": "YOUR_ACCESS_TOKEN",
        "STRETY_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN",
        "STRETY_CLIENT_ID": "YOUR_CLIENT_ID",
        "STRETY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

5. Restart Claude Code

The MCP server loads on Claude Code startup.

Available Tools

Read Tools

Tool	Description
strety_list_todos	List todos with optional filters (assignee, completed status)
strety_get_todo	Get full details of a specific todo
strety_list_people	List all people in the organization

Write Tools

Tool	Description
strety_create_todo	Create a new todo with title, description, assignee, due date, priority
strety_update_todo	Update fields on an existing todo (auto ETag handling)
strety_complete_todo	Mark a todo complete or uncomplete (auto ETag handling)
strety_delete_todo	Permanently delete a todo

Note: Write tools require OAuth tokens with read and write scopes. PATCH operations (update, complete) automatically fetch the required ETag before sending the request.

Token Management

The server handles token refresh automatically:

1. Tokens are loaded from ~/.mcp-strety/token.json (preferred) or environment variables
2. When a 401 occurs, the server attempts to refresh using the refresh token
3. New tokens are saved back to ~/.mcp-strety/token.json

Important: Tokens expire after 2 hours. The auto-refresh handles this, but if the refresh token also expires, you'll need to re-authorize.

API Notes

• Base URL: https://2.strety.com/api/v1
• Page size limit: 20 items max per request
• Rate limit: 10 requests per 10 seconds
• Pagination: Server fetches up to 50 pages to find all matching todos

Troubleshooting

"Authentication failed" error

1. Check if tokens are expired
2. Try refreshing manually (see oauth-flow.md)
3. If refresh fails, re-authorize completely

"Invalid scope" or 403 when using write tools

The token only has read scope. Re-authorize with read+write scope (see OAuth flow docs).

Todos not showing up

The server paginates through up to 50 pages. If Brent's todos are spread across many pages, they should still be found. Check the assignee filter is correct.

Files

strety/
├── src/index.ts      # Main server code (7 tools)
├── dist/index.js     # Compiled output (gitignored)
├── package.json
├── tsconfig.json
├── .gitignore
├── README.md         # This file
└── docs/
    ├── README.md               # Docs index
    ├── strety-oauth-flow.md    # OAuth documentation
    ├── strety-api-mapping.md   # API endpoint reference
    └── strety-mcp-tools-spec.md # Tool specifications

Development

# Build
npm run build

# Watch mode (if configured)
npm run dev